Skip to content

Install dependencies

aube install installs the dependencies declared in package.json and the workspace manifests. It is the command to use for local setup, CI, Docker layers, and lockfile updates.

sh
aube install

Lockfile modes

ModeCommandUse it when
Prefer frozenaube install --prefer-frozen-lockfileLocal default: reuse a fresh lockfile, re-resolve on drift.
Frozenaube install --frozen-lockfileCI should fail if package.json and lockfile disagree.
No frozenaube install --no-frozen-lockfileYou want a full re-resolve.
Fix lockfileaube install --fix-lockfileYou want to repair only entries that drifted.
Lockfile onlyaube install --lockfile-onlyYou want to update the lockfile without linking node_modules.

aube ci is the strict CI shortcut: it deletes node_modules and then runs a frozen install.

Dependency filters

sh
aube install --prod
aube install --no-optional

--prod skips devDependencies. --no-optional skips optional dependencies.

Network modes

sh
aube install --prefer-offline
aube install --offline

--prefer-offline uses cached metadata when available and only hits the network on a miss. --offline forbids network access entirely.

Linker modes

sh
aube install --node-linker=isolated
aube install --node-linker=hoisted

isolated is the pnpm-compatible default. It writes a strict symlink tree under node_modules/.aube/. hoisted writes a flatter npm-style tree for projects that need legacy node_modules assumptions. pnp is not supported.

Store import methods

sh
aube install --package-import-method=auto
aube install --package-import-method=hardlink
aube install --package-import-method=copy
aube install --package-import-method=clone-or-copy

auto probes the filesystem and chooses the fastest available strategy: reflink, hardlink, then copy.

References

MIT Licenseen.devCopyright © 2026 en.dev