# Verdaccio

Verdaccio is a simple, zero-config-required local private NPM registry. It is open source and self-hosted, installable on Kubernetes (Helm), Unraid and Docker Hub.

Canonical page: https://ourlocalhost.com/app/30/verdaccio

## Description

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), also introduces caching the downloaded modules along the way. For those who are 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.

## Platform availability

Available on 2 of 9 platforms: Unraid, Helm.

## Health score

84/100 (Excellent), based on 4 of 4 factors.
- Maintained: 100 (last commit 19 days ago)
- Popular: 85 (17,913 GitHub stars)
- Easy to install: 45 (2 install platforms, install notes, Docker image)
- Light to run: 95 (512 MB minimum RAM, runs on ARM)

## Links

- GitHub: https://github.com/verdaccio/verdaccio
- Kubernetes (Helm): https://artifacthub.io/packages/helm/verdaccio/verdaccio
- Unraid: https://ca.unraid.net/apps/verdaccio-1yr6dp015tmj6w?q=Verdaccio
- Official website: https://verdaccio.org/
- Docker Hub: https://hub.docker.com/r/verdaccio/verdaccio/

## Common questions

### How do I make npm use my local Verdaccio registry instead of the public one?

Set npm clients to the local Verdaccio endpoint on port 4873 so installs go through your local registry. If you skip it, npm keeps using the public registry and your locally published packages may not be found.

### What persistent files should I configure so packages and logins survive restarts?

Give Verdaccio a persistent storage folder and an htpasswd authentication file in its configuration. If storage is not persistent, packages can disappear after a restart, and without the authentication file users cannot log in.

### How do I start the nginx reverse-proxy relative-path Docker Compose example?

Run docker compose up --build --force-recreate in the HTTP reverse-proxy example to start the containers. If you skip this, Verdaccio is not running and browsers or npm clients cannot connect.

### Can Verdaccio cache npmjs.org to reduce latency or help with outages?

Verdaccio can proxy npmjs.org and cache downloaded modules. If multiple servers install packages, this can decrease latency and provide limited failover.

### Can I chain multiple registries through one endpoint?

You can chain multiple registries so one project can fetch packages from multiple sources through one single endpoint.

## Alternatives

- npm: npm is a package manager for Node.js that is run through the command line and manages dependencies for an application.

---
Source: Our Local Host (https://ourlocalhost.com/app/30/verdaccio), the self-hosted and open-source app directory.