Installation

Verdaccio is a Node.js private and proxy registry. To install it, you need a few basic prerequisites.

Prerequisites

1. Node.js, matching the version of Verdaccio you install:

   Verdaccio	Node.js
   6.x (current)	>= 22
   7.x and later	>= 24

2. A Node package manager: pnpm, npm or yarn (classic and modern).

npm@10 or newer is recommended. Every supported Verdaccio already requires a Node.js release that bundles npm 10 or 11, so anything older is neither tested nor supported. Some features ask for more: npm stage needs npm@11.17, and the yarn plugins need yarn@4.

3. A modern web browser to use the web interface: Chrome, Firefox or Edge.

Verdaccio follows the Node.js Release Working Group recommendations for which Node.js versions it supports.

Quick Introduction

Learn the basics before getting started, how to install, where is the location of the configuration file and more.

Installing the CLI

Before using Verdaccio in production, please read and be aware of the best practices.

Verdaccio must be installed globally:

npm

npm install -g verdaccio

Yarn

yarn global add verdaccio

pnpm

pnpm add -g verdaccio

Bun

bun add --global verdaccio

Global installs are Yarn 1.x classic only; modern Yarn has no equivalent.

Basic Usage

Once it has been installed, you only need to execute the CLI command:

$> verdaccio
 info -=- local storage path /Users/user/.local/share/verdaccio/storage/.verdaccio-db.json
 info --- using htpasswd file: /Users/user/.config/verdaccio/htpasswd
 info --- http address http://localhost:4873/
 info --- version: 6.10.3
 info --- server started

For more information about the CLI, please read the cli section.

You can set the registry by using the following command.

npm set registry http://localhost:4873/

you can pass a --registry flag when needed.

npm install --registry http://localhost:4873

define in your .npmrc a registry field.

.npmrc

registry=http://localhost:4873

Or a publishConfig in your package.json

{
  "publishConfig": {
    "registry": "http://localhost:4873"
  }
}

For alternative configurations, please read the Using a private registry section.

Create Your Own Private NPM Package Tutorial

If you'd like a broader explanation, don't miss the tutorial created by thedevlife on how to Create Your Own Private NPM Package using Verdaccio.

Docker Image

docker run -it --rm --name verdaccio -p 4873:4873 verdaccio/verdaccio

Verdaccio has an official docker image you can use, and in most cases, the default configuration is good enough. For more information about how to install the official image, read the docker section, furthermore you can learn more about combining Docker images in our docker-examples repository.

Helm Chart

$ helm repo add verdaccio https://charts.verdaccio.org
$ helm repo update
$ helm install registry --set image.tag=6 verdaccio/verdaccio