verdaccio /verdaccio

A lightweight Node.js private proxy registry

★ 17,989⑂ 1,484👁 146⑃ 4,579● 1,264▤ 432
TypeScriptMITCreated 2016-04-15www.verdaccio.org/
Download: v7.1.1v7.1.1 ↓7.1.12026-11-15
+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

Discussions

Latest release

v7.1.1 v7.1.1 2026-11-15
Patch 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)

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON