Verdaccio keeps backward compatibility with all versions since the first release (v2.0.0), but there are some considerations you need to know before start a migration.

Migrating from sinopia@1.4.0 to Verdaccio 2.x/3.x

If you are using still using Sinopia, we encourage you to migrate as soon as possible due to Sinopia has been abandoned.

Installation with npm

Using as example UNIX environments, the local storage is located within ~/.local/share/ folder.

We support only sinopia@1.4.0 as minimum version, these are the steps:

  1. The folder ~/.local/share/sinopia must be renamed to ~/.local/share/verdaccio
  2. The folder ~/.config/sinopia must be renamed to ~/.config/verdaccio

There is an aditional step, not required, but recommended:

  1. The file ~/.config/sinopia/storage/.sinopia-db.json must be renamed to ~/.local/share/verdaccio/storage/.verdaccio-db.json

To find the Windows location, check the following link.

Using Docker

This might depends of your own configuration, but, if you are using external volumes we recommend following the step 3 in the previous section.

Migrating from verdaccio@2.x to verdaccio@3.x

Those versions are fully compatible, so there is not a specific step for migrating between both of them. But we recommend the following considerations:

  • Try to update first to the latest v2.x as possible. There were a lot of fixes and you might hit a corner case migrating from a very old version.
  • We recommend using the latest v3.x available version.

Migrating from verdaccio@3.x to verdaccio@4.x

Installation with npm

There are no differences between both major releases if you install with npm. The migration should be clean and painless.

If you decided to use the JWT token signature instead of the legacy one, all the client side tokens will be invalidated.

Installation with Docker

Environment Variables

The Docker image for version 3 allows the following environment variables:

PropertydefaultDescription
APPDIR/usr/local/appthe docker working directory
PORT4873the verdaccio port
PROTOCOLhttpthe default http protocol

Version 4 brings more control over the environment variables and provides a namespace to avoid collisions and new additions.

PropertydefaultDescription
VERDACCIO_APPDIR/opt/verdaccio-buildthe docker working directory
VERDACCIO_USER_NAMEverdacciothe system user
VERDACCIO_USER_UID10001the user id being used to apply folder permissions
VERDACCIO_PORT4873the verdaccio port
VERDACCIO_PROTOCOLhttpthe default http protocol