verdaccio /verdaccio
A lightweight Node.js private proxy registry
★ 17,989⑂ 1,484👁 146⑃ 4,579● 1,264▤ 432
+2
Daily
17,989
stars
1,484
forks
146
watchers
4,579
prs
1,264
issues
432
releases
README
Verdaccio stands for peace, stop the war, we will be yellow / blue 🇺🇦 until that happens. !verdaccio logo !verdaccio gif Version Next (Development Branch) Version 6 requires Node.js 22 or higher and is maintained in the 6.x branch. Version Next (this master branch) requires Node.js 24 or higher. Note that contributing guidelines might be different based on the branch. Verdaccio is a simple, zero-config-required local private npm registry. No need for an entire database just to get started! Verdaccio comes out of the box with its own tiny database, and the ability to proxy other registries (eg. npmjs.org), caching the downloaded modules along the way. For those looking to extend their storage capabilities, Verdaccio supports various community-made plugins to hook into services such as Amazon's s3, Google Cloud Storage or create your own plugin. Versions You can find more details about the different versions of Verdaccio, minimum requirements, as well as links to associated npm packages and docker images in the version history. For how releases are versioned, approved, and published across branches, see the release process. Install Version next-9 requires Node.js v24 or higher Install with npm: bash npm install -g verdaccio@next-9 With yarn bash yarn global add verdaccio@next-9 With pnpm bash pnpm i -g verdaccio@next-9 or bash docker pull verdaccio/verdaccio:nightly-master or with _helm_ official chart. bash helm repo add verdaccio https://charts.verdaccio.org helm repo update helm install verdaccio/verdaccio Furthermore, you can read the Debugging Guidelines and the Docker Examples for more advanced development. Plugins You can develop your own plugins with the verdaccio generator. Installing Yeoman is required. npm install -g yo npm install -g generator-verdaccio-plugin Learn more here how to develop plugins. Share your plugins with the community. End to End Testing We test compatibility across different versions of npm, pnpm, and Yarn to ensure your favorite commands — from publishing packages to managing dependencies — work seamlessly with Verdaccio. E2E CLI tests run in CI via the verdaccio-e2e tool on Node.js 24 and 26 against the following matrix: | Package Manager | Versions | | --------------- | -------- | | npm | 11, 12 | | yarn modern | 3, 4 | | pnpm | 11, 12 | | bun | 1.4.4 | Donations Verdaccio is run by volunteers; nobody works on it full-time. If you find this project useful and would like to support its development, consider making a long-term support donation — your logo will be featured in this section of the README. You can support the project via Donate 💵👍🏻 — starting from _just $1/month_, or with a one-time contribution. Note: There is currently no funding available for contributions or security research. What does Verdaccio do for me? Use private packages If you want to use all benefits of npm package system
Top issues
#4795Web UI doesn't work as a sidecar for non-localhost URLs7 comments · 2024-08-27#5992[Bug]: Web UI "Error loading manifests" — all `/-/verdaccio/data/*` endpoints return 4046 comments · 2026-07-06#3760plugin local-storage problem about file-locking2 comments · 2023-04-23#4541Copy authorization from request to proxy1 comments · 2024-03-14#6474Forward the client address and the incoming X-Forwarded-For chain to uplinks0 comments · 2026-11-15#6473X-Forwarded-For: undefined is sent to uplinks on tarball requests0 comments · 2026-11-15#6468verdaccio-aws-s3-storage: proxied tarball response truncated when a concurrent request already uploaded it (writeTarball 409)0 comments · 2026-11-15#6449feat(store): sign packages published to Verdaccio with a registry key0 comments · 2026-11-07
Discussions
#6440Add an optional PostgreSQL registry-state backend for highly available deployments0 comments · 2026-11-05#6428AWS S3 storage sync issue with verdaccio-aws-s3-storage0 comments · 2026-10-29#6379Recent verdaccio publishes (6.10.5, 6.10.6) are missing npm provenance / trusted-publisher attestations2 comments · 2026-10-21#6269When Verdaccio is expected to be released?3 comments · 2026-09-23#6262Verdaccio Architecture RFC: Top 2 High-Impact Feature Requests0 comments · 2026-09-21#6233Proposal: extend the verdaccio CLI0 comments · 2026-09-06#6130[Bug]: Publishing to verdaccio is very slow3 comments · 2026-08-13#6126Why doesn't `scope` support `versions` in package-filter rules?2 comments · 2026-08-11
Latest release
v7.1.1 v7.1.1 2026-11-15Patch Changes - e3415f7: Update the @verdaccio/ modules to the next-9 npm dist-tag. Patch changes - @verdaccio/ui-theme: chore(ui-theme): type clean-up (6456) - @verdaccio/store: chore(store): type clean-up (6457) - @verdaccio/api: Abort the storage read of a tarball download when the client disconnects before the response finishes. (6465) - @verdaccio/proxy: Fix the via header sent to an uplink growing with every request when the uplink has a headers option in the config. (6463) - @verdaccio/store: chore(store): skip storing secret if it's not changed (6458)