Installing the Google Cloud CLI Docker image

Stay organized with collections Save and categorize content based on your preferences.

The Google Cloud CLI Docker image lets you pull a specific version of gcloud CLI as a Docker image from Container Registry and quickly execute Google Cloud CLI commands in an isolated, correctly configured container.

The Google Cloud CLI Docker image is the gcloud CLI installed on top of a Debian or Alpine image. The Docker image is hosted on Container Registry with the following repository name: The images are also available using the,, and repositories.

Docker image options

There are five Google Cloud CLI Docker images: latest, slim, emulators, debian_component_based, and alpine. You can specify your preference by using the appropriate tag after the host repository name:

  • :latest, :VERSION: Large (Debian-based) image with additional components pre-installed.
  • :slim, :VERSION-slim: Smaller (Debian-based) image with no components pre-installed.
  • :emulators, :VERSION-emulators: Smaller (Debian-based) image with emulator components pre-installed.
  • :alpine, :VERSION-alpine: Smallest (Alpine-based) image with no additional components installed. This image supports linux/arm.
  • :debian_component_based, :VERSION-debian_component_based: Debian-based with all components. As opposed to :latest which used deb packages, this image uses the component manager to install components. This image supports linux/arm.

Installing a specified Docker image

  1. To use the image of the latest Google Cloud CLI release,, pull it from Container Registry by running the following command:

    docker pull
  2. If you've pulled the latest version, verify the installation by running:

    docker run --rm gcloud version

    If you pulled a specific version, verify the installation by running a command similar to the following sample:

    docker run --rm gcloud version
  3. Authenticate with the Google Cloud CLI by running:

    docker run -ti --name gcloud-config gcloud auth login

    After you've authenticated successfully, credentials are preserved in the volume of the gcloud-config container.

  4. List compute instances using these credentials to verify by running the container with --volumes-from:

    docker run --rm --volumes-from gcloud-config gcloud compute instances list --project your_project

Installing additional components

By default, the latest images ( and have all the Google Cloud CLI components installed.

The, and images, however, do not come with additional components pre-installed. You can extend these images by following the instructions below:

Debian-based images

To install an additional component, like google-cloud-sdk-datastore-emulator, run the following commands:

cd debian_slim/

docker build --build-arg CLOUD_SDK_VERSION=159.0.0 \
    --build-arg INSTALL_COMPONENTS="google-cloud-sdk-datastore-emulator" \
    -t my-cloud-sdk-docker:slim .

Alpine-based images

To install additional components for Alpine-based images, create a Dockerfile that uses the Google Cloud CLI image as the base image. For example, to add kubectl and app-engine-java components, create a Dockerfile to look like the following:

RUN apk --update add openjdk7-jre
RUN gcloud components install app-engine-java kubectl

Once done, run the following command:

docker build -t my-cloud-sdk-docker:alpine .

Installing specific versions of Google Cloud CLI

To install specific Google Cloud CLI versions, specify your preferred gcloud CLI version when running the docker build command:

docker build -t my-cloud-sdk-docker:alpine --build-arg CLOUD_SDK_VERSION=<release_number> .