Configure options below — the preview updates in real time.

Registry & Authentication

Controls the registry endpoints and authentication settings.

Base URL of the npm package registry.

Default scope (e.g. @myorg) for publishing scoped packages.

Access level when publishing scoped packages.

Authentication strategy used for login.

Strict SSLValidates SSL certificates when requesting registry data.

Path to a file containing multiple CA certificates.

Install Behavior

Controls how packages are installed and dependencies are resolved.

Save ExactSaves exact version matches rather than semver ranges when installing.

The semver prefix applied to saved package versions.

SaveSaves installed packages to package.json dependencies.
Save DevSaves packages to devDependencies by default.
Save OptionalSaves packages to optionalDependencies.
Save PeerSaves packages to peerDependencies.
Save BundleSaves packages to bundledDependencies list.
Legacy Peer DepsIgnores peer dependencies entirely like npm v4-v6 did.
Strict Peer DepsFails immediately on unresolvable peer dependencies.

Determines how dependencies are structured on disk.

Legacy BundlingUses legacy, deeply-nested node_modules installation.
Install LinksCopies linked packages rather than symlinking them.
Bin LinksWhether to create symlinks for package executables.
Engine StrictFails installation if Node/npm versions don't match the engines field.
Package LockGenerates a lockfile on install.
Package Lock OnlyOnly updates the lockfile without installing to node_modules.

Format version of package-lock.json.

Script Execution

Controls how npm handles package scripts.

Ignore ScriptsPrevents package lifecycle scripts from running during install.
Foreground ScriptsRuns installed package scripts in the foreground.
If PresentAvoids erroring if npm run-script targets a missing script.

The shell used to execute npm scripts.

Cache & Network

Controls caching, proxy settings, and network retries.

Location of npm's cache directory.

Prefer OfflineUses cache if available, bypassing staleness checks.
Prefer OnlineForces a staleness check with the registry, ignoring cache.
OfflineForces npm to use the cache without checking the network.

Proxy server for outgoing HTTP requests.

Proxy server for outgoing HTTPS requests.

Domains that should bypass the proxy settings.

Number of times to retry failed registry requests.

Maximum total time to wait for HTTP requests (in milliseconds).

Minimum timeout for a retry step (in milliseconds).

Maximum timeout for a retry step (in milliseconds).

Exponential backoff factor for retries.

Max number of concurrent sockets per host.

Versioning & Git

Controls version bumping and git tagging behavior.

Git Tag VersionTags the git commit when running npm version.
Commit HooksRuns git commit hooks when using npm version.
Sign Git CommitCryptographically signs the npm version git commit.
Sign Git TagCryptographically signs the npm version git tag.
Allow Same VersionPrevents throwing an error when npm version matches the current version.

The prefix used in git tags.

Default commit message for npm version. Use %s as version placeholder.

Output & Logging

Controls npm output verbosity and format.

Controls output verbosity.

JSON OutputOutputs commands in JSON format.

Toggles colored output in the terminal.

UnicodePermits Unicode characters in the npm tree output.
FundDisplays funding messages from installed packages.
AuditSubmits audit reports to the registry during install.

Minimum vulnerability level to exit with a non-zero code.

Update NotifierChecks for npm CLI updates and prints a notification.
TimingOutputs execution timing logic on exit.

Max number of log files to keep before cleaning up.

Init Defaults

Default values used when running npm init.

Default author name for npm init.

Default author email for npm init.

Default author URL for npm init.

Default license for npm init.

Default version for npm init.

Miscellaneous

Additional npm configuration options.

GlobalOperates in global context rather than project context.
ForceBypasses cache and protection checks to force execution.
Dry RunPreviews changes without actually modifying files.
Format Package LockAuto-formats package-lock.json output.

Defines the user-agent header for registry queries.

Default tag attached to registry publishing operations.

Max number of items to return in npm search.

PNPM Extensions

PNPM-specific settings that extend .npmrc. Only applicable when using PNPM.

Location where all package versions are saved globally by PNPM.

The directory where dependencies will be linked.

Directory for PNPM's hidden virtual store.

Strategy for placing packages into node_modules.

Resolution linker standard behavior for PNPM.

SymlinkCreates symlinks from the store to node_modules.
HoistHoists all dependencies into a single accessible flat layer.
Shamefully HoistFlattens all packages completely, resembling npm's legacy mode.

Glob patterns defining which dependencies should be hoisted.

*

Glob patterns for dependencies to hoist to root node_modules.

Strict Peer Dependencies (PNPM)Fails install entirely if a peer dependency is missing or invalid.
Auto Install PeersAutomatically installs missing non-optional peer dependencies.
Dedupe Peer DependentsDedupes packages requiring matching peer dependencies.

Controls version resolution logic across the dependency graph.

Bootstraps and uses a specific Node.js version implicitly.

Hoist Workspace PackagesHoists internal workspace projects to root node_modules.
Verify Store IntegrityValidates store files against their checksums prior to linking.
Side Effects CacheCaches package build side effects locally.
Side Effects Cache ReadonlyConsumes build caches but forbids writing new ones.
Lockfile Include Tarball URLAdds the full URL to the package's tarball to every entry in pnpm-lock.yaml.
Manage Package Manager VersionsAuto-installs exact package manager versions via the packageManager field in package.json.

Prevents targeted dependencies from running install scripts.

Restricts script execution to only explicitly named packages.

Directory holding PNPM's global executables and scripts.

Directory to hold PNPM cached state elements.

Directory to hold temporary metadata and cache for PNPM.