Stay organized with collections Save and categorize content based on your preferences.
This page contains instructions for choosing and maintaining a Google Cloud CLI installation. The Google Cloud CLI includes the gcloud
, gsutil
and bq
command-line tools. For a list of gcloud CLI features, see All features.
To access the Google Cloud APIs using a supported programming language, you can download the Cloud Client Libraries.
Installation instructionsThese instructions are for installing the Google Cloud CLI. For information about installing additional components, such as gcloud CLI commands at the alpha or beta release level, see Managing gcloud CLI components.
Note: If you are behind a proxy or firewall, see the proxy settings page for more information on installation. Linuxgcloud topic startup
.uname -a
at the command line.
To download the Linux archive file, run the following command:
curl -O https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/google-cloud-cli-linux-x86_64.tar.gz
Refer to the table above and replace google-cloud-cli-linux-x86_64.tar.gz with the *.tar.gz
package name that applies to your configuration.
tar -xf google-cloud-cli-linux-x86_64.tar.gzOptional: To replace an existing installation, remove the existing
google-cloud-sdk
directory and then extract the archive to the same location.PATH
. You can also opt-in to command-completion for your shell and usage statistics collection. Run the installation script (from the root of the folder you extracted in the last step) using the following command:
./google-cloud-sdk/install.shThis can also be done non-interactively (for example, using a script) and by providing preferences as flags. To view the available flags, run:
./google-cloud-sdk/install.sh --help
Y
when prompted.PATH
and enable command completion, answer Y
when prompted.PATH
in the previous step, open a new terminal so that the changes take effect.gcloud init
:./google-cloud-sdk/bin/gcloud init
gcloud
to automatically update to the latest version and you're running a modern Ubuntu release that uses the Snap Package Manager, you can install the Google Cloud CLI as a snap package.The gcloud CLI is available in package format for installation on Debian and Ubuntu systems. This package contains the gcloud
, gcloud alpha
, gcloud beta
, gsutil
, and bq
commands only. It doesn't include kubectl
or the App Engine extensions required to deploy an application using gcloud
commands. If you want these components, you must install them separately.
Before you install the gcloud CLI, make sure that your operating system meets the following requirements:
sudo apt-get update
apt-transport-https
and curl
installed:
sudo apt-get install apt-transport-https ca-certificates gnupg curl
For newer distributions (Debian 9+ or Ubuntu 18.04+) run the following command:
curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo gpg --dearmor -o /usr/share/keyrings/cloud.google.gpg
curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key --keyring /usr/share/keyrings/cloud.google.gpg add -
If your distribution's apt-key command doesn't support the --keyring
argument, run the following command:
curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key add -
If you can't get latest updates due to an expired key, obtain the latest apt-get.gpg key file.
echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] https://packages.cloud.google.com/apt cloud-sdk main" | sudo tee -a /etc/apt/sources.list.d/google-cloud-sdk.list
For older distributions that don't support the signed-by option, run the following command:
echo "deb https://packages.cloud.google.com/apt cloud-sdk main" | sudo tee -a /etc/apt/sources.list.d/google-cloud-sdk.list
cloud-sdk
repo in /etc/apt/sources.list.d/google-cloud-sdk.list
.sudo apt-get update && sudo apt-get install google-cloud-cliFor additional
apt-get
options, such as disabling prompts or dry runs, refer to the apt-get
man pages.
Docker Tip: If installing the gcloud CLI inside a Docker image, use a single RUN step instead:
RUN echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] https://packages.cloud.google.com/apt cloud-sdk main" | tee -a /etc/apt/sources.list.d/google-cloud-sdk.list && curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | gpg --dearmor -o /usr/share/keyrings/cloud.google.gpg && apt-get update -y && apt-get install google-cloud-cli -yFor older base images that do not support the
gpg --dearmor
command:
RUN echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] https://packages.cloud.google.com/apt cloud-sdk main" | tee -a /etc/apt/sources.list.d/google-cloud-sdk.list && curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | apt-key --keyring /usr/share/keyrings/cloud.google.gpg add - && apt-get update -y && apt-get install google-cloud-cli -y
google-cloud-cli
google-cloud-cli-anthos-auth
google-cloud-cli-app-engine-go
google-cloud-cli-app-engine-grpc
google-cloud-cli-app-engine-java
google-cloud-cli-app-engine-python
google-cloud-cli-app-engine-python-extras
google-cloud-cli-bigtable-emulator
google-cloud-cli-cbt
google-cloud-cli-cloud-build-local
google-cloud-cli-cloud-run-proxy
google-cloud-cli-config-connector
google-cloud-cli-datastore-emulator
google-cloud-cli-firestore-emulator
google-cloud-cli-gke-gcloud-auth-plugin
google-cloud-cli-kpt
google-cloud-cli-kubectl-oidc
google-cloud-cli-local-extract
google-cloud-cli-minikube
google-cloud-cli-nomos
google-cloud-cli-pubsub-emulator
google-cloud-cli-skaffold
google-cloud-cli-spanner-emulator
google-cloud-cli-terraform-validator
google-cloud-cli-tests
kubectl
For example, the google-cloud-cli-app-engine-java
component can be installed as follows:
sudo apt-get install google-cloud-cli-app-engine-java
gcloud init
to get started:
gcloud init
Downgrading gcloud CLI versions
To revert to a specific version of the gcloud CLI, where VERSION
is of the form 123.0.0
, run the following command:
sudo apt-get update && sudo apt-get install google-cloud-cli=123.0.0-0
The ten most recent releases are always available in the repo.
NOTE: For releases prior to 371.0.0, the package name is google-cloud-sdk
The gcloud CLI is available in package format for installation on Red Hat Enterprise Linux 7, 8, and 9; Fedora 33 and 34; and CentOS 7 and 8 systems. This package contains the gcloud
, gcloud alpha
, gcloud beta
, gsutil
, and bq
commands only. It doesn't include kubectl
or the App Engine extensions required to deploy an application using gcloud
commands, which can be installed separately as described later in this section.
sudo tee -a /etc/yum.repos.d/google-cloud-sdk.repo << EOM [google-cloud-cli] name=Google Cloud CLI baseurl=https://packages.cloud.google.com/yum/repos/cloud-sdk-el9-x86_64 enabled=1 gpgcheck=1 repo_gpgcheck=0 gpgkey=https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg EOM
libxcrypt-compat.x86_64
.
sudo dnf install libxcrypt-compat.x86_64
sudo dnf install google-cloud-cli
dnf
on your system, you can run these commands using yum
instead.
You can also use dnf
/yum
options, such as disabling prompts or dry runs, with the provided commands.
google-cloud-cli
google-cloud-cli-anthos-auth
google-cloud-cli-app-engine-go
google-cloud-cli-app-engine-grpc
google-cloud-cli-app-engine-java
google-cloud-cli-app-engine-python
google-cloud-cli-app-engine-python-extras
google-cloud-cli-bigtable-emulator
google-cloud-cli-cbt
google-cloud-cli-cloud-build-local
google-cloud-cli-cloud-run-proxy
google-cloud-cli-config-connector
google-cloud-cli-datastore-emulator
google-cloud-cli-firestore-emulator
google-cloud-cli-gke-gcloud-auth-plugin
google-cloud-cli-kpt
google-cloud-cli-kubectl-oidc
google-cloud-cli-local-extract
google-cloud-cli-minikube
google-cloud-cli-nomos
google-cloud-cli-pubsub-emulator
google-cloud-cli-skaffold
google-cloud-cli-spanner-emulator
google-cloud-cli-terraform-validator
google-cloud-cli-tests
kubectl
For example, the google-cloud-cli-app-engine-java
component can be installed as follows:
sudo dnf install google-cloud-cli-app-engine-java
gcloud init
to get started:
gcloud init
Downgrading gcloud CLI versions
If you'd like to revert to a specific version of the gcloud CLI, where VERSION
is of the form 123.0.0
, run: sudo dnf downgrade google-cloud-cli-VERSION
The ten most recent releases will always be available in the repository. NOTE: For releases prior to 371.0.0, the package name is google-cloud-sdk
python3 -V
or python -V
. Supported versions are Python 3.8 to 3.13.xcode-select -p
.sudo xcode-select --install
.gcloud topic startup
.uname -m
from a command line..tar.gz
archive file in the preferred location. Or run the following command:
tar -xf google-cloud-cli-darwin-arm.tar.gz
Optional: To replace an existing installation, remove the existing google-cloud-sdk
directory and then extract the archive to the same location.
./google-cloud-sdk/install.sh
The script will prompt to install Python 3.12 and certain recommended modules.
The install can also be done non-interactively (for example, using a script) by providing preferences as flags. To describe the available flags, run:./google-cloud-sdk/install.sh --helpTo run the install script with screen reader mode on:
./google-cloud-sdk/install.sh --screen-reader=trueOptional:
Y
when prompted.PATH
and enable command completion, answer Y
when prompted.PATH
in the previous step, open a new terminal so that the changes take effect.gcloud init
:./google-cloud-sdk/bin/gcloud init
Download the Google Cloud CLI installer.
Alternatively, open a PowerShell terminal and run the following PowerShell commands:
(New-Object Net.WebClient).DownloadFile("https://dl.google.com/dl/cloudsdk/channels/rapid/GoogleCloudSDKInstaller.exe", "$env:Temp\GoogleCloudSDKInstaller.exe") & $env:Temp\GoogleCloudSDKInstaller.exe
Launch the installer and follow the prompts. The installer is signed by Google LLC.
If you're using a screen reader, check the Turn on screen reader mode checkbox. This option configures gcloud
to use status trackers instead of unicode spinners, display progress as a percentage, and flatten tables. For more information, see the Accessibility features guide.
Google Cloud CLI requires Python; supported versions are Python 3.8 to 3.13. By default, the Windows version of Google Cloud CLI comes bundled with Python 3. To use Google Cloud CLI your operating system must be able to run a supported version of Python.
The installer installs all necessary dependencies, including the needed Python version. While Google Cloud CLI installs and manages Python 3 by default, you can use an existing Python installation if necessary by unchecking the option to Install Bundled Python. See gcloud topic startup
to learn how to use an existing Python installation.
After installation is complete, the installer gives you the option to create Start Menu and Desktop shortcuts, start the Google Cloud CLI shell, and configure the gcloud CLI. Make sure that you leave the options to start the shell and configure your installation selected. The installer starts a terminal window and runs the gcloud init
command.
gcloud
commands. These components can be installed using the gcloud CLI component manager.find
command not being recognized, ensure your PATH
environment variable is set to include the folder containing find
. Usually, this is C:\WINDOWS\system32;
.Depending on your development needs, instead of the recommended installation, you can use an alternative method of installing the gcloud CLI:
After you have installed the gcloud CLI, you can use commands in the gcloud components
command group to manage your installation. This includes viewing installed components, adding and removing components, and upgrading to a new version or downgrading to a specific version of the gcloud CLI.
Note: If you used
apt-get
or
yum
to install the gcloud CLI, you must use use
apt-get
or
yum
to update or remove components, not
gcloud components
.
Earlier versions of the gcloud CLIIf you need a different version of the gcloud CLI, install the current version using the instructions that appear earlier on this page and then log in. After you are logged in, you can download earlier releases. To see the versions sorted by date, be sure to enable Sort and filter and click the Created column.
Supported Python versionsThe Google Cloud CLI requires Python 3.8 to 3.13. For information on how to choose and configure your Python interpreter, see gcloud topic startup
.
If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
Get started for freeExcept as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-07-02 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-07-02 UTC."],[],[]]
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4