Installing from versioned archives

The gcloud CLI provides downloadable, versioned archives for each release. Each versioned archive contains a self-contained installation of the gcloud CLI 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 the gcloud CLI and are useful when:

  • You require a specific version of the gcloud CLI. For example:

    • You're scripting with the gcloud CLI or another gcloud CLI component and want to make sure that your scripts don't break as the result of a gcloud CLI update.
    • You're using the gcloud CLI 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're performing automated deployments of the gcloud CLI to many machines that must be in sync.
    • You're 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 the gcloud CLI 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

    Additionally, for macOS, to check your machine hardware name (x86_64, arm64, or x86), run uname -m.

  2. Download the appropriate archive compatible with your version:

    Platform Package Size SHA256 Checksum
    Linux 64-bit

    (x86_64)

    		 google-cloud-cli-linux-x86_64.tar.gz 96.1 MB bd0f7eab135cfe64ca28d4cf1c4af2b20da40c63966f05066a546de41775713e
    Linux 64-bit

    (Arm)

    		 google-cloud-cli-linux-arm.tar.gz 61.5 MB 1908a3c9feade59310532d555c02530301ed23f5eca524a6ef4bb6fe55396160
    Linux 32-bit

    (x86)

    		 google-cloud-cli-linux-x86.tar.gz 61.6 MB 6a19488ae14a8211b9d2f677f22cc219df0b51ecb1e2558501e136597d445d3f
    macOS 64-bit

    (x86_64)

    		 google-cloud-cli-darwin-x86_64.tar.gz 61.7 MB 3b6ef9a1fbf7f10449d767c1b9b58c23c0efa45b97e4cc7b1693d1883458ecc8
    macOS 64-bit

    (arm64)

    		 google-cloud-cli-darwin-arm.tar.gz 61.6 MB 7473a081d9b4cf78f250814dac7215090be5b0dd60c4628001967c2a8cfad60f
    macOS 32-bit

    (x86)

    		 google-cloud-cli-darwin-x86.tar.gz 60.0 MB 9a68aefedc1b58bd7586fd2c94235a46e57aecfea3181cefbd3950e3a902e158
    Windows 64-bit

    (x86_64)

    		 google-cloud-cli-windows-x86_64.zip 84.8 MB 032231d56bdc86cede7648e56720b3ef0eb9c3b9e4129e8f6f97286ce97e8c8a
    Windows 64-bit

    (x86_64) with Python bundled

    		 google-cloud-sdk-579.0.0-windows-x86_64-bundled-python.zip 111.1 MB b745410b717dac3403017cf98c5887a44e190b2e07502b3dbf2dca421c462526
    Windows 32-bit

    (x86)

    		 google-cloud-cli-windows-x86.zip 84.7 MB 14c8ef2cee66bbc909c22f8550691115662796cd7a20fda15ee58e465547c6bf
    Windows 32-bit

    (x86) with Python bundled

    		 google-cloud-sdk-579.0.0-windows-x86-bundled-python.zip 108.3 MB e9c65bbfd8452646ddc1276edf08b0fdf20f27b50790cbf6ff27a1402aee76be

  3. Extract the contents of the file to any location on your file system. Preferably, this is your Home folder.

  4. To add the gcloud CLI tools to your path, run the install script from the root of the folder you extracted. Running this script also generates instructions to enable command completion in your bash shell (Linux and macOS only) and enable usage reporting.

    • On Linux or macOS:

      ./google-cloud-sdk/install.sh

      To run the install script with screen reader mode turned on:

      ./google-cloud-sdk/install.sh --screen-reader=true

    • On Windows:

      .\google-cloud-sdk\install.bat

    Run install.sh --help or install.bat --help for a list of flags you can pass to this script, including those that can run the installation non-interactively.

  5. To initialize the gcloud CLI, run gcloud init:

    • For Linux or macOS:

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

    • For Windows:

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

Previous versions

Previous versions of the gcloud CLI are available in the download archive in Cloud Storage. They are directly accessible through https://storage.googleapis.com/cloud-sdk-release/<archive_name>.