doctl registries docker-config

Generated on 1 Apr 2026 from doctl version v1.154.0

Usage

doctl registries docker-config <registry-name> [flags]

Aliases

config

Description

Outputs a JSON-formatted Docker configuration that you can use to configure a Docker client to authenticate with your private container registry. This configuration is useful for configuring third-party tools that need access to your registry.

By default this command generates read-only credentials. Use the --read-write flag to generate credentials that can push. The configuration produced by this command contains a DigitalOcean API token that can be used to access your account and should be treated as sensitive information.

Example

The following example generates a Docker configuration for a registry named example-registry and uses the --expiry-seconds to set the credentials to expire after one day:

doctl registries docker-config example-registry --expiry-seconds=86400

Flags

Option Description
--expiry-seconds The length of time the registry credentials are valid for, in seconds. By default, the credentials do not expire.
Default: 0
--help, -h Help for this command
--read-write Generates credentials that can push to your registry
Default: false
Command Description
doctl registries Display commands for working with multiple container registries

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

    We can't find any results for your search.

    Try using different keywords or simplifying your search terms.