Installing from versioned archives

Cloud SDK provides downloadable, versioned archives for each release. Each versioned archive contains a self-contained installation of Cloud SDK in a directory named google-cloud-sdk that can be copied to any location on your file system.

Best uses for installing from versioned archives

Versioned archives are designed for non-interactive installation of specific versions of Cloud SDK and are useful when:

  • You require a specific version of Cloud SDK. For example:

    • You are scripting with the gcloud CLI or one of the other Cloud SDK components and want to make sure that your scripts don't break as the result of a Cloud SDK update.
    • You are using Cloud SDK as part of a CI (continuous integration) process or production system where you want to control your dependencies in order to ensure compatibility between parts of the system.
    • You are performing automated deployments of Cloud SDK to many machines that must be in sync with each other.
    • You are behind a proxy or firewall that requires additional configuration to be able to access the internet.
  • You don't want to perform an interactive installation.

Installation instructions

To install the latest release of Cloud SDK from a versioned archive:

  1. Check which version (64-bit or 32-bit) your OS is running on.

    • Linux / macOS: Run getconf LONG_BIT from your command line
    • Windows: Control Panel > System > System Type
  2. Download the appropriate archive compatible with your version:

    Platform Package Size SHA256 Checksum
    Linux 64-bit


    google-cloud-sdk-277.0.0-linux-x86_64.tar.gz 30.8 MB b158894c427712d006fac235daf8d288db110ecfbcf649ed11cdf36ac2b2ff2a
    Linux 32-bit


    google-cloud-sdk-277.0.0-linux-x86.tar.gz 30.4 MB 5d8c1f5e6bbeabf5f0a5874895f6b0a612df34f407f4d806f314101347da8c18
    macOS 64-bit


    google-cloud-sdk-277.0.0-darwin-x86_64.tar.gz 23.4 MB 772dffb2c1ee928f03ca3a8803e6677884302341be9e456190a7f9c2787ec94d
    macOS 32-bit


    google-cloud-sdk-277.0.0-darwin-x86.tar.gz 23.4 MB c2d63d25c42703f0203181ea098b0ff9b21f5ed0639a1de55089bb1cb3b81325
    Windows 64-bit

    (x86_64) 166.3 MB c5614d6cf3a1af5b663e9865f8e2d7040ad77ebac816106d2a96d15cff2d4cc7
    Windows 64-bit

    (x86_64) with Python bundled 204.7 MB 70cc49cfd39f692ec7b0cd3e4c4c3573f83d6f1bd7ed261d9c9c668b1cd42b2a
    Windows 32-bit

    (x86) 166.4 MB edbe96400e7ad378ddeaad11f79d99a318c515e6ef8f9bebf6ccf3d642834850
    Windows 32-bit

    (x86) with Python bundled 200.8 MB 68a08bf2b3671bd5526b2706656e82e69822113e734472c77a7d44b28be317eb
  3. Extract the contents of the file to any location on your file system. Preferably, this is your Home folder.

  4. Optional. If you'd like to add Cloud SDK tools to your path, run the install script. This should be run from the root of the folder you extracted above. Running this script will also generate instructions to enable command completion in your bash shell (Linux and macOS only) and enable usage reporting.

    • On Linux or macOS:

    • On Windows:


    Run --help or install.bat --help for a list of flags you can pass to this script.

  5. Run gcloud init to initialize the SDK:

    ./google-cloud-sdk/bin/gcloud init

Previous versions

Previous versions of Cloud SDK are available in the download archive in Google Cloud Storage. They are directly accessible through<archive_name>.