Skip to content

bun install CLI Usage

sh
bun install <name>@<version>

General Configuration

--configstring
Specify path to config file (bunfig.toml)
--cwdstring
Set a specific cwd

Dependency Scope & Management

--productionboolean
Don't install devDependencies
--no-saveboolean
Don't update package.json or save a lockfile
--saveboolean default: true
Save to package.json
--omitstring
Exclude 'dev', 'optional', or 'peer' dependencies from install
--only-missingboolean
Only add dependencies to package.json if they are not already present

Dependency Type & Versioning

--devboolean
Add dependency to "devDependencies"
--optionalboolean
Add dependency to "optionalDependencies"
--peerboolean
Add dependency to "peerDependencies"
--exactboolean
Add the exact version instead of the ^range

Lockfile Control

--yarnboolean
Write a yarn.lock file (yarn v1)
--frozen-lockfileboolean
Disallow changes to lockfile
--save-text-lockfileboolean
Save a text-based lockfile
--lockfile-onlyboolean
Generate a lockfile without installing dependencies

Network & Registry Settings

--castring
Provide a Certificate Authority signing certificate
--cafilestring
File path to Certificate Authority signing certificate
--registrystring
Use a specific registry by default, overriding .npmrc, bunfig.toml and environment variables

Installation Process Control

--dry-runboolean
Don't install anything
--forceboolean
Always request the latest versions from the registry & reinstall all dependencies
--globalboolean
Install globally
--backendstring default: clonefile
Platform-specific optimizations: "clonefile", "hardlink", "symlink", "copyfile"
--filterstring
Install packages for the matching workspaces
--analyzeboolean
Analyze & install all dependencies of files passed as arguments recursively

Caching Options

--cache-dirstring
Store & load cached data from a specific directory path
--no-cacheboolean
Ignore manifest cache entirely

Output & Logging

--silentboolean
Don't log anything
--verboseboolean
Excessively verbose logging
--no-progressboolean
Disable the progress bar
--no-summaryboolean
Don't print a summary

Security & Integrity

--no-verifyboolean
Skip verifying integrity of newly downloaded packages
--trustboolean
Add to trustedDependencies in the project's package.json and install the package(s)

Concurrency & Performance

--concurrent-scriptsnumber default: 5
Maximum number of concurrent jobs for lifecycle scripts
--network-concurrencynumber default: 48
Maximum number of concurrent network requests

Lifecycle Script Management

--ignore-scriptsboolean
Skip lifecycle scripts in the project's package.json (dependency scripts are never run)

Help Information

--helpboolean
Print this help menu