gcloud auth configure-docker

NAME
gcloud auth configure-docker - registergcloud as a Docker credential helper
SYNOPSIS
gcloud auth configure-docker[REGISTRIES][GCLOUD_WIDE_FLAG …]
DESCRIPTION
gcloud auth configure-docker adds the DockercredHelper entry toDocker's configuration file, or creates the file if it doesn't exist. This willregistergcloud as thecredential helper for all Google-supported Docker registries. If the Dockerconfiguration already contains acredHelper entry, it will beoverwritten.

Note:docker andgcloud need to be on the same systemPATH to work correctly.

Note: This command will not work fordocker installed via Snap, asthedocker snap package does not currently provide an interface forcredential helpers.

For more details on Docker registries, seehttps://docs.docker.com/registry/.

For more details on how to authenticate to Google Container Registry using thiscommand, seehttps://cloud.google.com/container-registry/docs/advanced-authentication#gcloud-helper.

For more details on Google Container Registry's standalone credential helpers,seehttps://github.com/GoogleCloudPlatform/docker-credential-gcr.

For more details on Docker credential helpers, seehttps://docs.docker.com/engine/reference/commandline/login/#credential-helpers.

EXAMPLES
To configure docker authentication after logging into gcloud, run:
gcloudauthconfigure-docker

To configure docker authentication with Container Registry, e.g.,gcr.io, run:

gcloudauthconfigure-dockergcr.io
POSITIONAL ARGUMENTS
[REGISTRIES]
The comma-separated list of registries to configure the credential helper for.Container Registry is a service for storing private container images. Foravailable registries, seehttps://cloud.google.com/container-registry/docs/pushing-and-pulling#add-registry.
GCLOUD WIDE FLAGS
These flags are available to all commands:--access-token-file,--account,--billing-project,--configuration,--flags-file,--flatten,--format,--help,--impersonate-service-account,--log-http,--project,--quiet,--trace-token,--user-output-enabled,--verbosity.

Run$gcloud help for details.

NOTES
These variants are also available:
gcloudalphaauthconfigure-docker
gcloudbetaauthconfigure-docker

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-05-07 UTC.