doctl auth [flags]
The doctl auth
commands allow you to authenticate doctl for use with your DigitalOcean account using tokens that you generate in the control panel at https://cloud.digitalocean.com/account/api/tokens.
If you work with a just one account, you can call doctl auth init
and supply the token when prompted. This creates an authentication context named default
.
To switch between multiple DigitalOcean accounts, including team accounts, you can create named contexts by using doctl auth init --context <name>
, then providing a token when prompted. This saves the token under the name you provide. To switch between accounts, use doctl auth switch --context <name>
.
Option | Description |
---|---|
--help , -h | Help for this command |
Command | Description |
---|---|
doctl | doctl is a command line interface (CLI) for the DigitalOcean API. |
doctl auth init | Initialize doctl to use a specific account |
doctl auth list | List available authentication contexts |
doctl auth switch | Switches between authentication contexts |
Option | Description |
---|---|
--access-token , -t | API V2 access token |
--api-url , -u | Override default API endpoint |
--config , -c | Specify a custom config file Default:
|
--context | Specify a custom authentication context name |
--output , -o | Desired output format [text|json] Default: text |
--trace | Show a log of network activity while performing a command Default: false |
--verbose , -v | Enable verbose output Default: false |