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., 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 and Google Cloud Storage.


  • Kubernetes 1.7+ with Beta APIs enabled
  • PV provisioner support in the underlying infrastructure

Use private packages

If you want to use all benefits of npm package system in your company without sending all code to the public, and use your private packages just as easy as public ones.

Cache registry

If you have more than one server you want to install packages on, you might want to use this to decrease latency (presumably “slow” will be connected to only once per package/version) and provide limited failover (if is down, we might still find something useful in the cache) or avoid issues like How one developer just broke Node, Babel and thousands of projects in 11 lines of JavaScript, Many packages suddenly disappeared or Registry returns 404 for a package I have installed before.

Link multiple registries

If you use multiples registries in your organization and need to fetch packages from multiple sources in one single project you might take advance of the uplinks to feature with Verdaccio, chaining multiple registries and fetching from one single endpoint.

Override public packages

If you want to use a modified version of some 3rd-party package (for example, you found a bug, but maintainer didn’t accept pull request yet), you can publish your version locally under the same name.

See in detail each of these use cases.


Verdaccio aims to support all features of a standard npm client that make sense to support in private repository. Unfortunately, it isn’t always possible.

Basic features

  • Installing packages (npm install, npm upgrade, etc.) – supported
  • Publishing packages (npm publish) – supported

Advanced package control

  • Unpublishing packages (npm unpublish) – supported
  • Tagging (npm tag) – supported
  • Deprecation (npm deprecate) – not supported – PR-welcome

User management

  • Registering new users (npm adduser {newuser}) – supported
  • Transferring ownership (npm owner add {user} {pkg}) – not supported, PR-welcome

Misc stuff

  • Searching (npm search) – supported (cli / browser)
  • Ping (npm ping) – supported
  • Starring (npm star, npm unstar) – not supported, PR-welcome


  • npm audit – supported

Verdaccio has evolved since the fork in 2016. Thanks of the community the project is still running and improving in several ways, a new UI, the product more stable and reliable, but still, there is a lot to do and I encourage you to contribute and make this amazing project stronger and popular.

There are other options outside for npm proxy servers, but, verdaccio wants to be a fast and portable npm private registry free solution for the community.

Tell us about a new Kubernetes application


Never miss a thing! Sign up for our newsletter to stay updated.


Discover and learn about everything Kubernetes