Skip to main content

Command Line Tool

The Verdaccio CLI is your tool to start and stop the application.


verdaccio --listen 4000 --config ~./config.yaml
--listen \ -l4873-p 7000http port
--config \ -c~/.local/verdaccio/config.yaml~./config.yamlthe configuration file
--info \ -iprints local environment information

Default config file location

To locate the home directory, we rely on $XDG_DATA_HOME as a first choice and for Windows environments we look for the APPDATA environment variable.

Config file format

Config files should be YAML, JSON or a NodeJS module. YAML format is detected by parsing config file extension (yaml or yml, case insensitive).

Default storage location

We use the $XDG_DATA_HOME environment by variable default to locate the storage by default which should be the same as $HOME/.local/share. If you are using a custom storage, this location is irrelevant.

Default database file location

The default database file location is in the storage location. Starting with version 4.0.0, the database file name will be .verdaccio-db.json for a new installation of Verdaccio. When upgrading an existing Verdaccio server, the file name will remain .sinopia-db.json.

Environment variables

Full list of environment variables.

  • VERDACCIO_HANDLE_KILL_SIGNALS to enable gracefully shutdown (since v4.12.0)