CLI Reference
vessl configure
Setup a VESSL environment
vessl configure [OPTIONS]
Option | Description |
---|---|
-t , --access-token | Access token used for authorization |
-o , --organization | Default organization |
-p , --project | Default project |
-f , --credentials-file | Path to file containing configuration data |
--renew-token | Renew access token |
Change the default organization
Set the default organization so that you do not enter the organization every time you execute the vessl
command.
vessl configure organization [ORGANIZATION]
Argument | Description |
---|---|
ORGANIZATION | New default organization |
Change the default project
Set the default organization so that you do not enter the project every time you execute the vessl
command.
vessl configure project [PROJECT]
Argument | Description |
---|---|
PROJECT | New default project |
View the current configuration
vessl configure list
Configuration Precedence
You can configure your VESSL environment in multiple ways. Here is a list of ways, in order of precedence.
- Command line arguments / options:
-o
,-p
options andORGANIZATION
,PROJECT
arguments. - Credentials file option:
-f
, a path to a file containing configuration data. - Environment variables:
VESSL_ACCESS_TOKEN
,VESSL_DEFAULT_ORGANIZATION
. - Credentials file environment variable:
VESSL_CREDENTIALS_FILE
. - Default credentials file: a configuration file maintained by VESSL located at
~/.vessl/config
.
The
--renew-token
flag for vessl configure
will take precedence over other methods and renew your access token.