Skip to main content

​
Config file

The CLI stores its configuration at ~/.versori/config.yaml by default. You can override this with the --config flag or the VERSORI_CONFIG environment variable. The config file holds your contexts (name, organisation ID, JWT) and tracks which context is currently active.

​
Contexts

A context groups together an organisation ID and a JWT token under a name. The active context is used by default for all commands. You can switch contexts with versori context select or override per-invocation with the --context flag. 
versori context add \
  --name production \
  --organisation <organisation-id> \
  --jwt <jwt-token>

versori context select --name production
See the context commands reference for all available operations.

​
Project-level configuration

When you run versori projects sync, a .versori file is created in the target directory containing the project ID and context name. This allows subsequent commands like save and deploy to infer the project automatically when run from that directory. If the context int he file doesn’t match the active context the CLI will exit with an error.

​
Global flags

These flags are available on every command.
FlagShortDefaultDescription
--config-c~/.versori/config.yamlPath to the config file
--context-x(active context)Use a specific context for this invocation
--output-otableOutput format: table(default), json, or yaml