.TH "GCLOUD_AUTH_CONFIGURE\-DOCKER" 1



.SH "NAME"
.HP
gcloud auth configure\-docker \- register \f5gcloud\fR as a Docker credential helper



.SH "SYNOPSIS"
.HP
\f5gcloud auth configure\-docker\fR [\fIREGISTRIES\fR] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

gcloud auth configure\-docker adds the Docker \f5credHelper\fR entry to Docker's
configuration file, or creates the file if it doesn't exist. This will register
\f5gcloud\fR as the credential helper for all Google\-supported Docker
registries. If the Docker configuration already contains a \f5credHelper\fR
entry, it will be overwritten.

Note: \f5docker\fR and \f5gcloud\fR need to be on the same system \f5PATH\fR to
work correctly.

Note: This command will not work for \f5docker\fR installed via Snap, as the
\f5docker\fR snap package does not currently provide an interface for credential
helpers.

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

For more details on how to authenticate to Google Container Registry using this
command, see
https://cloud.google.com/container\-registry/docs/advanced\-authentication#gcloud\-helper.

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

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



.SH "EXAMPLES"

To configure docker authentication after logging into gcloud, run:

.RS 2m
$ gcloud auth configure\-docker
.RE

To configure docker authentication with Container Registry, e.g., \f5gcr.io\fR,
run:

.RS 2m
$ gcloud auth configure\-docker gcr.io
.RE



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m
[\fIREGISTRIES\fR]

The comma\-separated list of registries to configure the credential helper for.
Container Registry is a service for storing private container images. For
available registries, see
https://cloud.google.com/container\-registry/docs/pushing\-and\-pulling#add\-registry.


.RE
.sp

.SH "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 \fB$ gcloud help\fR for details.



.SH "NOTES"

These variants are also available:

.RS 2m
$ gcloud alpha auth configure\-docker
.RE

.RS 2m
$ gcloud beta auth configure\-docker
.RE