Skip to main content
Version: 5.x

Command Line Tool

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

Commands

verdaccio --listen 4000 --config ~./config.yaml
CommandDefaultExampleDescription
--listen \ -lhttp:localhost:48737000Define protocol + host + port (formats)
--config \ -c~/.local/verdaccio/config.yaml~./config.yamlSet location of the configuration file
--info \ -iPrint local environment information
--version \ -vShow version information

Default config file location

To locate the home directory, verdaccio relies 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.

You can use VERDACCIO_STORAGE_PATH to define an alternative storage path, read more about VERDACCIO_STORAGE_PATH at the environment variables page.

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.

The database name sinopia-db.json is deprecated and support will be removed after v6.x

Environment variables

Full list of environment variables.