pnpm
Dev ToolsFast, disk space efficient package manager
Release History
v11.0.0-rc.0Breaking2 fixes11 featuresThis major release enforces Node.js 22+ compatibility, transitions pnpm to pure ESM, and significantly enhances security by enabling supply-chain protection defaults. It also overhauls configuration handling, moving most settings out of .npmrc, and introduces a new SQLite-backed store index for faster installations.
v11.0.0-beta.8Breaking1 fix13 featuresThis release introduces major architectural changes, including migrating the package index store to SQLite and isolating global package installations for better stability. Configuration handling has been significantly updated, moving most settings away from .npmrc files to pnpm-workspace.yaml and standardizing CLI output formats.
v11.0.0-beta.7Breaking1 fix21 featuresThis release introduces major architectural changes focused on performance and security, including migrating the store index to SQLite, isolating global packages, and hardening configuration loading by deprecating reliance on `.npmrc` for non-auth settings. CLI output has also been cleaned up.
v11.0.0-beta.6Breaking3 fixes12 featuresThis release introduces significant performance improvements via a new SQLite-backed store index and isolated global package installations. It also cleans up CLI output, updates configuration handling (especially around build dependencies and workspace configs), and drops support for older Node.js versions.
v11.0.0-beta.5Breaking3 fixes9 featuresThis release introduces major architectural changes, including migrating the content-addressable store index to SQLite (Store v11) and isolating global package installations for better stability. Configuration handling has been significantly overhauled, moving project-specific settings from `.npmrc` to `pnpm-workspace.yaml` and changing CLI output formats.
v11.0.0-beta.4Breaking9 featuresThis release introduces significant internal changes, including a new SQLite-based store index format (Store v11) and isolated global package installations for better stability. Configuration handling has been overhauled, moving away from rc files and standardizing CLI output formats to
v11.0.0-beta.3Breaking11 featuresThis major release introduces significant architectural changes to the content-addressable store using SQLite and optimizes metadata storage, alongside isolating global package installations for better stability. Configuration handling has been overhauled, moving away from rc files and project-specific .npmrcs in favor of centralized workspace configuration.
v10.33.010 fixes1 featureThis release introduces the `dedupePeers` setting to significantly reduce peer dependency duplication and includes numerous fixes for concurrent operations, Windows command execution, and lockfile handling.
v11.0.0-beta.2Breaking14 featuresThis major release introduces significant architectural changes to the content-addressable store using SQLite and optimizes metadata storage, alongside isolating global package installations for better stability. Many deprecated configuration options and commands have been removed, and pnpm is now pure ESM.
v11.0.0-beta.1Breaking13 featuresThis major release introduces significant architectural changes to the content-addressable store using SQLite and optimizes metadata storage, while isolating global package installations for better stability. Configuration handling has been overhauled, moving project-specific settings out of `.npmrc` and standardizing CLI output formats.
v11.0.0-beta.0Breaking1 fix20 featuresThis major release introduces significant performance improvements via a new SQLite-backed content-addressable store index and isolates global package installations. Configuration handling has been overhauled, moving project-specific settings from `.npmrc` to `pnpm-workspace.yaml` and standardizing CLI output formats.
v11.0.0-alpha.16Breaking11 featuresThis release introduces major architectural changes to the pnpm store, moving to SQLite for metadata indexing and isolating global package installations for better stability. Configuration commands and build dependency handling have also been significantly overhauled, and support for older Node.js versions has been dropped.
v11.0.0-alpha.15Breaking20 featuresThis release introduces major architectural changes to the pnpm store, moving to SQLite for indexing and isolating global packages for better stability. Configuration handling has been significantly overhauled, moving away from rc files and standardizing output formats.
v10.32.11 fixThis patch release fixes a regression related to how pnpm handles `pnpm-workspace.yaml` files that omit the `packages` field, ensuring configuration-only files do not incorrectly define workspace roots.
v11.0.0-alpha.14Breaking15 featuresThis release introduces major architectural changes to the content-addressable store using SQLite and optimizes metadata storage, alongside isolating global package installations for better stability. Configuration handling has been significantly overhauled, moving settings out of rc files and standardizing output formats.
v10.32.02 fixes1 featureThis release introduces the --all flag for approving builds non-interactively and reverts two recent changes that caused regressions, including one related to npm config file path setting and another concerning lockfile-include-tarball-url.
v10.31.011 fixes3 featuresThis patch release improves configuration preservation in pnpm-workspace.yaml, fixes several critical bugs related to linking, race conditions during store imports, and patch operations, and adds a short alias for the --filter option.
v11.0.0-alpha.13Breaking14 featuresThis release introduces major architectural changes to the pnpm store, moving to SQLite for metadata indexing and isolating global package installations for improved stability. Configuration handling has been significantly overhauled, favoring JSON output and consolidating workspace settings into `pnpm-workspace.yaml`.
v11.0.0-alpha.12Breaking1 fix12 featuresThis release introduces major architectural changes focused on performance and isolation, including switching internal store formats to MessagePack, isolating global packages, and updating configuration handling. Several deprecated features and configuration options related to build dependencies and linking have been removed.
v10.30.31 fixThis patch release fixes an issue where version switching failed when pnpm was installed as a standalone executable without a system Node.js environment.
v11.0.0-alpha.11Breaking3 fixes17 featuresThis release introduces major performance improvements across the store by switching to MessagePack and optimizing index formats, alongside significant changes to configuration loading, moving away from INI/rc files towards YAML for pnpm-specific settings. Many deprecated configuration options and commands have been removed, and the package is now pure ESM.
v10.30.22 fixesThis patch release fixes an issue where auto-installed peer dependencies ignored overrides and resolves an input line length error on Windows when using the global virtual store. It also includes a dependency update to patch a moderate vulnerability.
v11.0.0-alpha.10Breaking2 fixes16 featuresThis release introduces major performance improvements by switching internal store formats to MessagePack and optimizing index storage. Configuration handling has been significantly overhauled, moving away from rc files and standardizing on YAML for pnpm-specific settings, alongside dropping support for older Node.js versions.
v10.30.11 fixThis patch release updates the primary endpoint used for fetching security audits to improve reliability.
v10.30.01 fix1 featureThis release updates pnpm why to display a reverse dependency tree for better readability and reverts a dependency pruning change in pnpm why to ensure correctness. Performance for pnpm why and pnpm list in large workspaces has also been improved.
v11.0.0-alpha.5Breaking2 fixes12 featuresThis major release introduces significant performance improvements by switching internal store formats to MessagePack and optimizing index storage. It also brings substantial changes to configuration handling, replacing INI formats with JSON for config commands and standardizing workspace configuration via `pnpm-workspace.yaml`.
v11.0.0-alpha.4Breaking3 fixes21 featuresThis major release introduces significant performance improvements by switching internal store formats to MessagePack and optimizing index storage. Configuration handling has been overhauled, moving project-specific settings out of .npmrc files into pnpm-workspace.yaml and changing CLI output formats.
v10.29.34 fixesThis patch release resolves several bugs, including an out-of-memory error in dependency listing commands and issues with configuration settings in `.pnpmfile.cjs` and `pnpm dlx`. Additionally, `pnpm deploy` behavior is corrected regarding the global virtual store setting.
v10.29.21 fixThis patch release reverts a previous fix (from v10.29.1) that was causing issues, restoring functionality for 'pnpm run -r' when an empty workspace file is present.
v10.29.110 fixes3 featuresThis release introduces support for the `catalog:` protocol in `pnpx` and allows configuring `auditLevel` in `pnpm-workspace.yaml`. Numerous bug fixes address issues related to JSON output, store path resolution, audit command behavior, and dependency handling.
v10.29.010 fixes3 featuresThis release introduces support for the `catalog:` protocol in `pnpx` and allows configuring `auditLevel` in `pnpm-workspace.yaml`. Numerous bugs were fixed, including issues related to JSON output, store path resolution, audit command behavior, and dependency hoisting configuration.
v10.28.23 fixesThis patch release focuses on security improvements by preventing path traversal in `directories.bin` and securing symlink handling for local dependencies. It also fixes an issue related to optional dependency metadata fetching for platform checks.
v10.28.17 fixes2 featuresThis patch release focuses heavily on security by fixing multiple path traversal vulnerabilities in ZIP and binary fetching, and improves dependency resolution by supporting plain HTTP/HTTPS git URLs. It also adjusts the exit code behavior for filtered script execution.
v11.0.0-alpha.3Breaking1 fix8 featuresThis release introduces significant configuration restructuring, replacing project-specific .npmrc files with packageConfigs in pnpm-workspace.yaml and restricting configuration loading from rc files. It also updates default behaviors, removes deprecated build dependency settings, and shifts the runtime environment to a bundled Node.js version.
v10.28.0v10.27.0Breaking5 fixes4 featuresThis release adds trust‑policy ignore options, project registry and mark‑and‑sweep pruning for the global virtual store, and includes several bug fixes, with a semi‑breaking change to unscoped package storage layout.
v10.26.22 fixes4 featuresThis patch release improves error messages, fixes Git annotated‑tag handling, writes runtime binaries earlier in the install lifecycle, and reduces network calls when `preferOffline` is used.
v10.26.12 fixesPatch release fixing pnpm add behavior with blockExoticSubdeps and improving git reference resolution to full commits.
v11.0.0-alpha.2Breaking11 featurespnpm 9.x introduces pure ESM packaging, a bundled Node runtime, JSON‑based config output, camelCase keys, and V8‑binary store, while dropping Node 18/19 support and changing several CLI behaviours.
v10.26.0Breaking3 fixes7 featuresThis release adds supply‑chain security features like `blockExoticSubdeps` and integrity hashing, introduces the unified `allowBuilds` config, and brings several usability improvements such as `--dry‑run` for `pack` and better deprecation displays.
v10.25.04 fixes2 featuresThis release adds certificate loading via `cert`, `ca`, and `key` fields and a `--bare` flag for `pnpm init`, plus several bug fixes around script reporting, build handling, forced publishing, and trust‑policy time errors.
v10.24.05 fixes1 featureThis release adds automatic network concurrency scaling for high‑core systems and includes several bug fixes around trust policies, file linking, self‑update behavior, package detection, and auth token handling.
v10.23.0Breaking4 fixes2 featuresThis release adds a new `--lockfile-only` flag to `pnpm list`, improves self‑update handling, displays npm protocols for aliased packages, and includes several bug fixes and stricter trust‑policy enforcement.
v11.0.0-alpha.0Breaking1 fix11 featurespnpm 9 introduces pure ESM, JSON‑based config output, V8‑serialized store files, and drops Node.js v18/v19 support, requiring migration of config files, imports, and runtime versions.
v10.22.01 fix2 featuresThis release introduces `trustPolicyExclude` and `publishConfig.engines` support, and fixes a hardlinking crash.
v10.21.03 fixes3 featuresThis release adds automatic Node.js runtime installation for dependencies, introduces a new \"trustPolicy\" setting, and adds a command to retrieve the global config path, while fixing several bugs around update behavior, hardlinking, and workspace configuration.
v10.20.03 fixes1 featureThis release adds the `--all` option to `pnpm --help` and includes several bug fixes related to version selection, the `create` command, and package manager version handling.
v10.19.02 featuresThis release introduces version‑specific controls for postinstall scripts and release‑age exclusions, enhancing security and flexibility in dependency management.
v10.18.39 fixesThis patch release fixes several bugs related to configuration handling, publishing, bin linking, and workspace behavior, improving the stability of pnpm commands.
v10.18.25 fixesThis patch release fixes several command issues, reduces the CLI bundle size by swapping ndjson for split2, and improves metadata handling for pnpm dlx.
v10.18.12 fixes1 featureThis patch release silences an unnecessary warning for `--lockfile-only`, adds a Windows shim for `pnpm setup` to support self‑updates, and corrects catalog warning behavior.
v10.18.05 fixes2 featuresThis release adds network performance monitoring with configurable thresholds and includes several bug fixes such as retrying EAGAIN filesystem errors and respecting `minimumReleaseAge` in various commands.
v10.17.13 fixesThis patch release fixes error messaging, workspace state file creation, and improves handling of `minimumReleaseAge` for selecting the latest version.
v10.17.02 fixes1 featureThis release adds pattern support to the `minimumReleaseAgeExclude` configuration and fixes two bugs related to minimumReleaseAge handling and prerelease downgrades.
v10.16.12 fixesThis patch release resolves a metadata cache bug and ensures patch diffs are generated without ANSI color codes.
v10.16.04 fixes3 featuresThis release adds a `minimumReleaseAge` safety setting and custom finder support, while fixing several bugs such as Node.js 24 deprecation warnings and improving error handling for `nodeVersion`.
v10.15.12 fixesThis patch release fixes a crash in `.pnp.cjs` and improves peer dependency resolution in workspaces.
v10.15.0Breaking4 fixes7 featuresThis release adds several new configuration capabilities, improves config handling, restores glibc 2.26 support, and includes a semi‑breaking change to peer‑dependency resolution.
v10.14.06 fixes2 featuresThis release adds JavaScript runtime installation support and new CLI flags for architecture selection, plus several bug fixes and integrity improvements.
v10.14.0-03 fixes3 featuresThis release adds new CLI flags for architecture selection, introduces devEngines‑based Node.js runtime resolution, improves dlx flag parsing, and fixes several bugs around package downloading and production installs.
v10.13.11 featureThis patch updates pnpm to run user‑defined pnpmfiles after plugin pnpmfiles.
v10.13.05 fixes2 featuresThis release adds support for multiple pnpmfiles and automatic loading of pnpmfile.cjs from config dependencies, while fixing several configuration conflicts, sorting behavior, rebuild handling, and command quoting.
v10.12.44 fixesThis patch release resolves several bugs: the `pnpm licenses` command for local dependencies, incorrect JSON output for non‑existent filters, a peer‑dependency deadlock, and restores proper hoisting after `pnpm fetch`.
v10.12.31 fixThis patch restores the hoisting of optional peer dependencies when using an outdated lockfile, fixing a regression introduced in v10.12.2.
v10.12.24 fixesThis patch release fixes several CLI bugs, including hoisting with `enableGlobalVirtualStore`, help flag handling for `pnpm create`, incorrect license list paths, and a deployment failure caused by outdated lockfiles.
v10.12.1Breaking2 fixes6 featuresThis release introduces experimental global virtual stores, catalog enhancements, new CLI options, and a new CI flag, while changing side‑effects cache keys (requiring cache cleanup) and fixing several regressions.
v10.11.18 fixesThis patch release resolves multiple regressions and bugs affecting pnpm deploy, URL‑based dependencies, strict peer dependency handling, environment variable naming, lockfile generation, overrides handling, URL parsing, and silent run output.
v10.11.04 fixes8 featuresThis release adds several new features such as module‑type init, Nushell support, audit ignore flags, recursive packing, and improves workspace behavior, while also fixing bugs related to peer dependencies, configuration loading, Node.js 24 warnings, and script execution.
v10.10.04 fixes1 featureThis release adds support for loading preResolution, importPackage, and fetchers hooks from a local pnpmfile and includes several bug fixes such as the cd command with shellEmulator, workspace yaml key sorting, and npm_package_json propagation.
v10.9.0Breaking1 fix2 featuresThis release adds JSR package installation support and a new `dangerouslyAllowAllBuilds` setting, fixes a verifyDepsBeforeRun false negative, and drops verifyDepsBeforeRun support for nodeLinker "pnp".
v10.8.12 fixes1 featureThis patch release removes bright white highlighting, adds automatic writing of `onlyBuiltDependencies` to `pnpm-workspace.yaml` when no config exists, and ensures patch file paths are stored as relative paths.
v10.8.03 fixes2 featuresThis release adds an experimental configuration hook and a new --config flag for pnpm add, and includes several bug fixes around workspace globs, audit overrides, and link behavior.
v10.7.13 fixesPatch release that corrects config type conversion, auth config retrieval, and expands `~/` in .npmrc paths.
v10.7.01 fix6 featuresThis minor release adds workspace‑aware config commands, env‑var support in workspace files, version‑range based dependency patching, a new ignore‑patch‑failures option, and fixes audit output memory issues.
v10.6.54 fixesThis patch release fixes several issues: it removes post‑approval warnings, preserves the `ignoredBuilds` field, corrects `catalog:` protocol handling in injected workspace packages, and allows non‑positive `workspace-concurrency` values.
v10.6.43 fixesThis patch release fixes pnpm dlx with the --allow-build flag, prevents invalid Node.js versions from breaking pnpm, and reduces the max linking workers to four for better performance.
v10.6.32 fixes1 featurePatch release fixing a crash in `pnpm install --prod=false`, adding missing `node-options` to `recursive run`, and cleaning up the `dedupe-peer-dependents` code path.
v9.15.91 fixThis patch release fixes a Windows-specific issue where running the pnpm CLI from within itself failed when the CLI was bundled as an executable.
v10.6.22 fixes4 featuresThis patch release fixes Windows CLI execution issues, improves self‑update behavior, aligns patch‑commit filesystem handling, adds proper handling of log level errors, and enables peerDependencyRules configuration via pnpm‑workspace.yaml.
v9.15.83 fixesThis patch release fixes self-update version handling, prevents CLI hangs with --silent, and silences extra output when --loglevel=error.
v10.6.15 fixesThis patch release fixes several CLI hanging and output issues, restores handling of patchedDependencies, improves approve-builds behavior, and adds registry info for missing package versions.
v10.6.06 fixes3 featuresThis release adds support for .npmrc settings in pnpm-workspace.yaml, improves tarball dependency performance, replaces fast-glob with tinyglobby, and includes several bug fixes for self-update, deploy, and update commands.
v9.15.74 fixes1 featureThis patch release introduces a new scoped registry CLI option and resolves several bugs affecting self‑update, interactive update listings, and catalog entry preservation.
v10.5.21 fixThe patch restores the default behavior of `pnpm config set` to modify the global .npmrc file.
v10.5.15 fixesThis patch release fixes several issues: it adds an error for incorrect workspace config filenames, corrects workspace updates via approve-builds, normalizes link paths in package.json, enables overrides in pnpm-workspace.yaml, and makes pnpm dlx ignore local package.json settings.
v10.5.02 fixes6 featuresThis release adds support for defining `pnpm.*` settings in `pnpm-workspace.yaml`, introduces automatic syncing of injected workspace packages after scripts, makes the `packages` field optional, and includes several command enhancements and bug fixes.
v9.15.65 fixesThis patch release fixes several bugs related to corepack updates, version output, packageManager version format, and catalog handling during filtered installs.
v10.4.14 fixesThis patch release fixes several CLI behaviors: it adds validation for overlapping `--allow-build` values, prints version info after execution time, warns on ignored builds during repeat installs, and restores proper handling of `init-package-manager`.
v10.4.0Breaking3 fixes2 featurespnpm v10 introduces `--global` support for approve-builds, a new `--allow-build` flag for add, and several bug fixes and documentation updates.
v10.3.02 fixes1 featurev10 introduces the `strict-dep-builds` setting for stricter script validation and includes fixes for `verify-deps-before-run` false negatives and improved warning display.
v10.2.14 fixesThis patch release fixes side‑effects cache handling, improves `pnpm approve-builds` in sub‑workspaces, and restores `pnpm deploy --legacy` functionality with clearer error guidance.
v10.2.05 fixes1 featurepnpm v10 introduces default building of packages run via `dlx` and `create`, adds several bug fixes, and improves handling of overrides and proxy settings.
v9.15.52 fixes3 featuresThis patch release adds support for preprepare/postprepare scripts during pnpm install, improves script argument quoting on POSIX, respects proxy settings for Git dependencies, validates package names on publish, and replaces strip-ansi with the built-in util.stripVTControlCharacters.
v10.1.08 fixes4 featuresThis release introduces new commands (`pnpm ignored-builds`, `pnpm approve-builds`), a performance‑focused setting, and a field to ignore built dependencies, while also fixing several bugs around publishing, scripts execution, peerDependencies handling, and internal utilities.
v9.15.41 fixThis patch release fixes recursive `pnpm update --latest` to correctly update only the targeted package when `dedupe-peer-dependents` is enabled.
Common Errors
TimeoutError1 reportTimeoutError in pnpm often arises from network congestion or slow server responses when downloading packages. Increase the `network-concurrency` setting in your `.npmrc` or `.pnpmfile.cjs` to allow more simultaneous downloads. Alternatively, switch to a faster mirror using the `registry` setting to improve package retrieval speed.
OnFatalError1 reportThe "OnFatalError" error in pnpm, often manifesting as "JavaScript heap out of memory," usually arises from insufficient memory allocated to Node.js during dependency installation, especially with large projects. Increase the Node.js heap size by setting the `NODE_OPTIONS` environment variable before running pnpm install, for example, `NODE_OPTIONS="--max-old-space-size=4096" pnpm install`. You can also try using a smaller, more targeted install by specifying particular dependencies.
Related Dev Tools Packages
Empowering everyone to build reliable and efficient software.
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
Playwright is a framework for Web Testing and Automation. It allows testing Chromium, Firefox and WebKit with a single API.
Next generation frontend tooling. It's fast!
An extremely fast Python package and project manager, written in Rust.
A bundler for javascript and friends. Packs many modules into a few bundled assets. Code Splitting allows for loading parts of the application on demand. Through "loaders", modules can be CommonJs, AMD, ES6 modules, CSS, Images, JSON, Coffeescript, LESS, ... and your custom stuff.
Subscribe to Updates
Get notified when new versions are released