---
title: "Deploy Verdaccio npm Registry"
description: "Private npm registry and npmjs.org cache, login required, sign-up closed"
category: "Other"
url: https://railway.com/deploy/verdaccio-npm-registry
---

# Deploy Verdaccio npm Registry

Private npm registry and npmjs.org cache, login required, sign-up closed

**[Deploy Verdaccio npm Registry on Railway](https://railway.com/template/verdaccio-npm-registry)**

Machine-readable deploy manifest (JSON, validated by TemplateCI): https://railway.com/deploy/verdaccio-npm-registry/manifest.json

- **Creator:** Anton Orel's Projects
- **Category:** Other
- **Total deploys:** 2

## Template content

### Verdaccio

- **Image:** verdaccio/verdaccio:7.1.2@sha256:4addf64c2fd5f86e963444e8a482d7cd20cd2243e01470d548bdb23d0cd609de
- **Start command:** `/bin/sh -ec "printf %s 'H4sIAAAAAAACA71V227cNhB911cM4AK+wKt1CiQI5CDowt4CAXIx7CTtm8EVR1p6KVIhKSvbr+8ZSr408HPfJGp4zlzOHB3Qdw5a1bXxVHvXmHYIKhnvqPGB0pbpWhk7qj0l7nqrEpf0FacxqZBwo+uU08TdhnUsDnDBRGqMZdrsE2eM/HAU62D6FJf3HEyzL+OW6i3Xu0gmHZ9S9OQ83atg1AZ3a+WAFRh8NSOipIutci1Hcsya1GMuQrA7p8hIc726/LQuO10WMfmgWq5I2KbalvPZUqukit4OrXHxPwHzWVGMvKkKomSSBcRjd3BkPSIqSmHgolBD2krcNvUqxlHLM+XSX+R9CMtRB7R4RbX1ERVFts0icrg3KDVwa2KaB3Dk+o6U1gO+Hj/v+hhU33OYocZgEnBkVEp3xk0AaHwTfEff19eXq4uLD19u0Z4Pn2+/3ayvP68+rQljmwF+Dbla3dz89eX68pw6H5iEPsqkeUJ8NsmpxoVElPVdLDNgp37e5jsVqiyKobfG7aK0B/XcxalPQ7AVWpf6WC2Xc9X7MgeUPrTLAvNfg2GPlih9Sv2wsQaiEbEN7uFN1BAhhzyYrCLpwgMcGdGLwVEAmpowaupVvcNEaOtjguoCMMn37KgP/idk7ukxjbKYg3PWh3+cLE8Op/xROEdU+JvIgF0yNdQ4NXRO7sVvj6m/fFMSqCZ64Tv5/9gKUSAHodsx9ytr7vmr6dgPqaI3ZzjWPom4kYVp0TUW6RvNV8a1H30b57UQPc2GcRiJNfoc2WFIfy/+9GFUQbOWp4re1dYgofen9C6HQegBRb7PI55XP2Y85fawBjtwnu50TVDTNPHRC3VEWRhpH6G/nWjgR2n6ZxfKDPVRhEJBnMOaziSIJ2RYTJ/DAzZsIEF15BuKWwRoeBixqNE7FqDMdzX173eR6mrQJoHUwid901T0tBwqfzqyXqF0QXE0Cl92ysh1XnU8qo2UdAywZmpUfJY9ernCAH0w/0zesEV+HE5ziCwbAp58PPkdYx2Szyb6627RiJWYyqHsMHPuPwaOcNpLE8WDsXM4VS6Osv2vz86AJRchCPlPJIXEXfu0KucZSzqnrCXv7J5QhIMndEZry3iZtijTTbJml5kqapSNsFSscXbefQ8PjUmDC69oR6egwrvonZgwMp+9oyjMq7dOrohnA27x7ab4F/a7Sz/RBgAA' | base64 -d | gunzip >/tmp/verdaccio-config.yaml; printf %s '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' | base64 -d | gunzip >/tmp/verdaccio-user.cjs; printf %s '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' | base64 -d | gunzip >/tmp/verdaccio-start.sh; exec /bin/sh /tmp/verdaccio-start.sh"`
- **Health check:** /-/ping
- **Public domain:** Yes

## Documentation

# Deploy and Host Verdaccio npm Registry on Railway

Verdaccio is an open-source private npm registry. You publish your own packages to it with the normal npm, pnpm or Yarn commands, and it fetches and caches public packages from npmjs.org, so one registry URL serves both.

## About Hosting Verdaccio npm Registry

The template runs Verdaccio 7.1.2 from the official image, pinned by digest, as one service with a 5 GB volume for packages, the npmjs.org cache and user accounts. The registry starts closed: every download, publish and unpublish needs a login, so it is neither a public package host nor an open npm proxy, and self-service sign-up is turned off. On every boot the template writes one administrator from VERDACCIO_ADMIN_USERNAME (admin by default) and a generated VERDACCIO_ADMIN_PASSWORD, which you copy from the service's variables before running npm login. More users are added with a small helper over railway ssh. The configuration is embedded in the start command, so no variable can loosen the access rules, and Verdaccio runs as the image's unprivileged user.

## Why Deploy Verdaccio npm Registry on Railway

Railway provides the HTTPS domain, the persistent volume, a generated password and health-checked deploys. Tarball URLs follow the HTTPS domain automatically, and Verdaccio's login rate limit sees each client's own address behind Railway's proxy.

## Common Use Cases

- Publish private npm packages for a team or a CI pipeline without a paid npm organization
- Cache npmjs.org packages so installs keep working and stay fast when the public registry is slow
- Test package releases end to end before publishing them to npmjs.org

## Dependencies for Verdaccio npm Registry Hosting

The deployment uses [Verdaccio](https://github.com/verdaccio/verdaccio) ([verdaccio.org](https://verdaccio.org)) and fetches public packages from npmjs.org.

### Deployment Dependencies

- Verdaccio 7.1.2 with a 5 GB volume
- Outbound HTTPS to registry.npmjs.org for public packages
- npm 9 or later on your machines (npm 9 and 10 log in with npm login --auth-type=legacy)


## Similar templates

- [Rocky Linux](https://railway.com/deploy/rocky-linux) — Hosted Rocky Linux 9 workspace with SSH and persistent storage. 🚀
- [Foundry Virtual Tabletop](https://railway.com/deploy/X5tR6G) — Self-hosted virtual tabletop for role-playing games (license required)
- [Double Commander in your browser](https://railway.com/deploy/double-commander-in-your-browser) — The Double Commander file manager in the cloud, from any device

Open this page in a browser: https://railway.com/deploy/verdaccio-npm-registry
