Google Cloud Platform
Cloud SDK

Google Cloud SDK contains tools and libraries that enable you to easily create and manage resources on Google Cloud Platform, including App Engine, Compute Engine, Cloud Storage, BigQuery, Cloud SQL, and Cloud DNS.

Installation and Quick Start

There are two main ways to get the Google Cloud SDK:

  • Use one of the installers listed below to easily get the latest available version of the SDK.
  • Download a static archive of the SDK that can be extracted and used without requiring installation. This option will also allow you to easily get a specific verison of the SDK.

For more information and other packages and versions, see our downloads page.


Linux

Use the installer to get the latest version (96.0.0) of the Google Cloud SDK:

  1. Run the following command in your shell or terminal:

    curl https://sdk.cloud.google.com | bash

    As an alternative to curl, you can download google-cloud-sdk.tar.gz , unpack it, and launch the ./google-cloud-sdk/install.sh script.

  2. Restart your shell:

    exec -l $SHELL
  3. Run gcloud init to authenticate, set up a default configuration, and clone the project's Git repository.

Get a static build of the Google Cloud SDK:

These static archives are versioned and do not require running the installation script. Choose from one of the packages below and extract it to the directory of your choice. To get started, run ./google-cloud-sdk/bin/gcloud init

Platform Package Size SHA1 Checksum
Linux (x86_64) google-cloud-sdk-96.0.0-linux-x86_64.tar.gz 7.1 MB 3ef31ad845e53f792424c2720e79ef554cf0265e
Linux (x86) google-cloud-sdk-96.0.0-linux-x86.tar.gz 7.1 MB 191c992a7da513b3780478b2f9b3b2372d440eab

For other packages and versions, see our downloads page.

Mac OS X

Use the installer to get the latest version (96.0.0) of the Google Cloud SDK:

  1. Run the following command in your shell or terminal:

    curl https://sdk.cloud.google.com | bash

    As an alternative to curl, you can download google-cloud-sdk.tar.gz , unpack it, and launch the ./google-cloud-sdk/install.sh script.

  2. Restart your shell:

    exec -l $SHELL
  3. Run gcloud init to authenticate, set up a default configuration, and clone the project's Git repository.

Get a static build of the Google Cloud SDK:

These static archives are versioned and do not require running the installation script. Choose from one of the packages below and extract it to the directory of your choice. To get started, run ./google-cloud-sdk/bin/gcloud init

Platform Package Size SHA1 Checksum
Mac OS X (x86_64) google-cloud-sdk-96.0.0-darwin-x86_64.tar.gz 7.1 MB 56e8ea1abbf54c39a739acc60924faf79690bce9
Mac OS X (x86) google-cloud-sdk-96.0.0-darwin-x86.tar.gz 7.1 MB 9629853e1b69b4b916a926ee102bb874a1116fad

For other packages and versions, see our downloads page.

Windows

Use the installer to get the latest version (96.0.0) of the Google Cloud SDK:

  1. Download the Google Cloud SDK installer for Windows.

  2. Launch the downloaded GoogleCloudSDKInstaller.exe installer and follow the prompts.

  3. When the installation finishes, open a command prompt (cmd.exe) or the Google Cloud SDK Shell from the Desktop or Start Menu.

  4. Run gcloud init to initialize a local Git repository, authenticate, and set up a default configuration.

    gcloud init

Get a static build of the Google Cloud SDK:

These static archives are versioned and do not require running the installation script. Choose from one of the packages below and extract it to the directory of your choice. To get started, run ./google-cloud-sdk/bin/gcloud init

Platform Package Size SHA1 Checksum
Windows (x86_64) google-cloud-sdk-96.0.0-windows-x86_64.zip 11.0 MB 37fc91cc100d6fe9a32a2ede902599bca60352d0
Windows (x86) google-cloud-sdk-96.0.0-windows-x86.zip 11.0 MB 663c413cc17708170dee7a5cdfd1ff060551eb1a

For other packages and versions, see our downloads page.

Debian/Ubuntu

The Cloud SDK is available in package format for installation on Debian and Ubuntu systems. This package contains the gcloud, gsutil and bq commands only.

You can install the Cloud SDK from a repo for all official Ubuntu releases that have not reached end of life, and Debian stable releases from wheezy onward.

Note: The Cloud SDK deb package does not include kubectl or the App Engine SDKs. If you want them, you must install them separately.

# Create an environment variable for the correct distribution
export CLOUD_SDK_REPO="cloud-sdk-$(lsb_release -c -s)"

# Add the Cloud SDK distribution URI as a package source
echo "deb http://packages.cloud.google.com/apt $CLOUD_SDK_REPO main" | sudo tee /etc/apt/sources.list.d/google-cloud-sdk.list

# Import the Google Cloud public key
curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key add -

# Update and install the Cloud SDK
sudo apt-get update && sudo apt-get install google-cloud-sdk

# Run gcloud init to get started
gcloud init
Alternative methods

Here are the alternative methods for installing Google Cloud SDK.

Install a specific Cloud SDK version

If necessary, it is possible to install previous versions of the Cloud SDK. You can do this either with a fresh installation, or by updating an existing installation to a previous version. In the following examples VERSION is the version number of the Cloud SDK you want to install (like 0.9.66).

  1. If doing a fresh install:

    export CLOUDSDK_COMPONENT_MANAGER_FIXED_SDK_VERSION=VERSION
    curl https://sdk.cloud.google.com | bash
  2. If you have an existing installation:

    export CLOUDSDK_COMPONENT_MANAGER_FIXED_SDK_VERSION=VERSION
    gcloud components update
  3. If you want to make that setting persistent (to prevent accidental upgrades):

    gcloud config set --scope=installation component_manager/fixed_sdk_version VERSION

Installation on Windows using Cygwin

  1. Download and install a 32-bit version of Cygwin, following Cygwin's installation instructions. While installing Cygwin, be sure to select openssh, curl and the latest 2.7.x version of python from the package selection screen.

  2. Launch Cygwin from Start → All Programs → Cygwin → Cygwin Terminal.

  3. Download and install the Google Cloud SDK by running the following command in your Cygwin terminal:

    curl https://sdk.cloud.google.com | bash

    (Or, you can download google-cloud-sdk.tar.gz, unpack it, and launch the ./google-cloud-sdk/install.sh script.)

  4. Restart Cygwin Terminal.

  5. Run gcloud init to get started with the Cloud SDK.

Installation from an archive (.zip) on Windows

  1. Download google-cloud-sdk.zip and extract the contents (right-click the file and choose "Extract All...").

  2. Launch the google-cloud-sdk\install.bat script and follow the installation prompts.

  3. When the installation finishes, restart the command prompt ( cmd.exe).

  4. Run gcloud init to get started with the Cloud SDK.

Next Steps

Get started with the Cloud SDK command-line interface

With the Cloud SDK command-line interface, you can easily manage your service resources and your development workflow:

  • To get an overview of the the gcloud command-line tool, see the gcloud Tool Guide.
  • To learn about the gcloud command-line tool in more detail, see the gcloud reference.

Submit questions and give us feedback

Have a question? Ask on StackOverflow using the "gcloud" tag or check out our groups page.

Found a bug? File it in our issue tracker site. Any feedback is appreciated!

Looking to stay up-to-date with the latest Cloud SDK releases or other news? Join the google-cloud-sdk-announce mailing list.

Learn more

gcloud Tool Guide

Learn more about gcloud, Cloud SDK command-line tool to manage your development workflow.

Cloud Platform Tools

Learn about App Engine, Compute, Storage, BigQuery and Cloud SQL tools, bundled with Cloud SDK.

Cloud Platform Solutions

See how you can quickly and easily build a mobile, gaming, or other solution.