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 |