Verdaccio Migration Guides
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:
- The folder
~/.local/share/sinopia
must be renamed to~/.local/share/verdaccio
- The folder
~/.config/sinopia
must be renamed to~/.config/verdaccio
There is an aditional step, not required, but recommended:
- 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
Here you can read more about summary o of changes by Diego Louzán.