[ Web Proxy ]
URL:
Viewing: https://docs.digitalocean.com/reference/doctl/reference/auth [Back]  [Original]
doctl auth | DigitalOcean Documentation

For AI agents: The documentation index is at https://docs.digitalocean.com/llms.txt. Markdown versions of pages use the same URL with index.html.md in place of the HTML page (for example, append index.html.md to the directory path instead of opening the HTML document).

doctl auth

Generated on 18 Aug 2026 from doctl version v1.167.0

Copy page as Markdown View page as Markdown

Description

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, 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, create named contexts using doctl auth init --context <name>, then providing the applicable token when prompted. This saves the token under the name you provide. To switch between contexts, use doctl auth switch --context <name>.

To remove accounts from the configuration file, run doctl auth remove --context <name>. This removes the token under the name you provide.

Flags

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 remove Remove authentication contexts
doctl auth switch Switch between authentication contexts
doctl auth token Display current authentication context API token

Global Flags

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
    --http-retry-max Set maximum number of retries for requests that fail with a 429 or 500-level error
    Default: 5
    --http-retry-wait-max Set the minimum number of seconds to wait before retrying a failed request
    Default: 30
    --http-retry-wait-min Set the maximum number of seconds to wait before retrying a failed request
    Default: 1
    --interactive Enable interactive behavior. Defaults to true if the terminal supports it (default false)
    Default: false
    --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

    In this article...

    We can't find any results for your search.

    Try using different keywords or simplifying your search terms.

    Web Proxy Viewer  |  New URL  |  Original Page