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.
firstname.lastname@example.org 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.
Using as example UNIX environments, the local storage is located within
We support only
email@example.com as minimum version, these are the steps:
- The folder
~/.local/share/sinopiamust be renamed to
- The folder
~/.config/sinopiamust be renamed to
There is an aditional step, not required, but recommended:
- The file
~/.config/sinopia/storage/.sinopia-db.jsonmust be renamed to
To find the Windows location, check the following link.
This might depends of your own configuration, but, if you are using external volumes we recommend following the step 3 in the previous section.
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.xas 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
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
JWTtoken signature instead of the
legacyone, all the client side tokens will be invalidated.
Installation with Docker
The Docker image for version
3 allows the following environment variables:
|APPDIR||the docker working directory|
|PORT||the verdaccio port|
|PROTOCOL||the default http protocol|
Version 4 brings more control over the environment variables and provides a namespace to avoid collisions and new additions.
|VERDACCIO_APPDIR||the docker working directory|
|VERDACCIO_USER_NAME||the system user|
|VERDACCIO_USER_UID||the user id being used to apply folder permissions|
|VERDACCIO_PORT||the verdaccio port|
|VERDACCIO_PROTOCOL||the default http protocol|