Skip to main content


You can find instructions to deploy Verdaccio on a Kubernetes cluster on the verdaccio/docker-example repository. However, the recommended method to install Verdaccio on a Kubernetes cluster is to use Helm. Helm is a Kubernetes package manager which bring multiple advantages.


Ṣeto Helm

Ti o ko ba ti lo Helm ri tẹlẹ, o nilo lati ṣeto oludari Helm ti a pe ni Tiller:

helm init

Fi sori ẹrọ

⚠️ If you are using this helm chart, please be aware of the migration of the repository.

Samulo Helm atẹ stable/verdaccio. Ninu apẹẹrẹ yii a lo npm gẹgẹbi orukọ igbejade:

Ṣamulo pato ẹya kan

helm install --name npm stable/verdaccio

Akiyesi: aṣẹ yi n pa gbogbo awọn ohun elo rẹ, pẹlu awọn akopọ ti o le ti gbejade tẹlẹ si ibi iforukọsilẹ naa.

helm install --name npm --set image.tag=2.6.5 stable/verdaccio

Deploy a specific version

helm upgrade npm stable/verdaccio

Upgrading Verdaccio

helm del --purge npm


wget -O config.yaml

O le ṣe iṣeto Verdaccio ni akanṣe pẹlu lilo Kubernetes configMap.

Custom Verdaccio configuration

Se adakọ iṣeto titẹlẹ ki o si mu ṣe deede fun lilo ọrọ rẹ:


Akiyesi: Ri daju pe o n lo ọna ti o tọ fun ibi ipamọ ti o jẹ lilo fun aiduro:

wget -O config.yaml

Ṣamulo configMap si iṣupọ naa

storage: /verdaccio/storage/data
file: /verdaccio/storage/htpasswd

Deploy the configMap

Ni bayi o le ṣe amulo atẹ Verdaccio Helm ati ṣiṣe pato iru iṣeto to ma jẹ lilo:

kubectl create configmap verdaccio-config --from-file ./config.yaml

Deploy Verdaccio

Rancher jẹ pilatifọọmu isakoso apoti pipe ti o n jẹ ki iṣakoso ati lilo awọn apoti ni iṣelọpọ rọrun gidi gan.

helm install npm --set existingConfigMap=verdaccio-config verdaccio/verdaccio

Authenticate with private upstreams using Helm

As of version 4.8.0 of the helm chart, a new secretEnvVars field has been added.
This allows you to inject sensitive values to the container via a Kubernetes Secret.

  1. Update your Verdaccio config according to the Uplinks documentation
  2. Pass the secret environment variable to your values file or via --set secretEnvVars.FOO_TOKEN=superSecretBarToken
# values.yaml
FOO_TOKEN: superSecretBarToken

NGINX proxy body-size limit

The standard k8s NGINX ingress proxy allows for 1MB for body-size which can be increased by modifying the default deployment options according to the documentation:


... 20m

Rancher Support

Rancher is a complete container management platform that makes managing and using containers in production really easy.