Stay organized with collectionsSave and categorize content based on your preferences.
Install the Google Cloud CLI
This quickstart describes the recommended method to install and initialize the
Google Cloud CLI. After initialization, run a few core
gcloud CLI commands to view information about your installation
and verify it was successful.
To follow step-by-step guidance for this task directly in the
Google Cloud console, clickGuide me:
Sign in to your Google Cloud account. If you're new to
Google Cloud,create an accountto evaluate how our products perform in
real-world scenarios. New customers also get $300 in free credits to
run, test, and deploy workloads.
In the Google Cloud console, on the project selector page,
select or create a Google Cloud project.
Roles required to select or create a project
Select a project: Selecting a project doesn't require a specific
IAM role—you can select any project that you've been
granted a role on.
Create a project: To create a project, you need the Project Creator role
(roles/resourcemanager.projectCreator), which contains theresourcemanager.projects.createpermission.Learn how to grant
roles.
In the Google Cloud console, on the project selector page,
select or create a Google Cloud project.
Roles required to select or create a project
Select a project: Selecting a project doesn't require a specific
IAM role—you can select any project that you've been
granted a role on.
Create a project: To create a project, you need the Project Creator role
(roles/resourcemanager.projectCreator), which contains theresourcemanager.projects.createpermission.Learn how to grant
roles.
When you finish the tasks that are described in this document, you can avoid
continued billing by deleting the resources that you created. For more information, seeClean up.
Install gcloud CLI version 549.0.1
Linux
Confirm that you have a supported version of Python. The Google Cloud CLI requires
Python 3.9 to 3.14. The x86_64 Linux package includes
a bundled Python interpreter that will be preferred by default. For
information on how to choose and configure your Python interpreter, see thegcloud topic startupdocumentation.
You can also perform the installation non-interactively by providing flags.
To view available flags, run:
./google-cloud-sdk/install.sh--help
Optional: If you updated yourPATHin the previous step, open a new
terminal so that the changes take effect.
Debian/Ubuntu
Package contents
The gcloud CLI is available in package format for installation on Debian and Ubuntu
systems. This package contains thegcloud,gcloud alpha,gcloud beta,gsutil, andbqcommand-line tools only. It
doesn't includekubectlor the App Engine extensions required to deploy an
application usinggcloudcommands. If you want these components, you mustinstall them separately.
Before you begin
Before you install the gcloud CLI, make sure that your operating system meets the
following requirements:
It is an Ubuntu release that hasn't reachedend-of-lifeor a Debian stable
release that hasn't reachedend-of-life.
It has recently updated its packages. To do this now, run the following command:
sudoapt-getupdate
It hasapt-transport-https,ca-certificates,gnupg,
andcurlinstalled. To install these packages, run the following command:
The ten most recent releases are always available in the repo. For releases prior to 371.0.0,
the package name isgoogle-cloud-sdk
Red Hat/Fedora/CentOS
Package contents
The gcloud CLI is available in package format for installation on
Red Hat Enterprise Linux 7, 8, 9, and 10; Fedora 41 and 42; and CentOS 7 and 8 systems.
This package contains thegcloud,gcloud alpha,gcloud beta,gsutil, andbqcommands only. It doesn't includekubectlor the App Engine
extensions required to deploy an application usinggcloudcommands, which can be
installed separately as described later in this section.
Installation
Update DNF with gcloud CLI repository information.
The following sample command is for a Red Hat Enterprise Linux 7, 8, or 9-compatible
installations, but make sure that you update the settings as needed for your
configuration:
For example, to install thegoogle-cloud-cli-app-engine-javacomponent, run the
following command:
sudodnfinstallgoogle-cloud-cli-app-engine-java
Downgrade gcloud CLI versions
To revert to a specific version of gcloud CLI, run the following command. Replace123.0.0with the version that you want to install:
sudodnfdowngradegoogle-cloud-cli-123.0.0
The ten most recent releases are available in the repository. For releases prior to 371.0.0, usegoogle-cloud-sdkas the package name.
macOS
Confirm that you have a supported version of Python. The Google Cloud CLI requires
Python 3.9 to 3.14.
To check your Python version, runpython3 -Vorpython -V.
The installation script can install Python for you if needed. This requiresXcode Command Line Tools.
To install them, runsudo xcode-select --install. Alternatively, you can install a supported Python version frompython.org.
For more information about configuring your Python interpreter, especially if you have
multiple versions installed, see thegcloud topic startupdocumentation.
Launch the installer and follow the prompts. The installer is signed by Google LLC.
If you're using a screen reader, check theTurn on screen reader modecheckbox. This
option configuresgcloudto use status trackers instead of unicode spinners,
display progress as a percentage, and flatten tables. For more information, see theAccessibility features guide.
Google Cloud CLI requires Python; supported versions are Python 3.9 to 3.14. 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 byuncheckingthe option to Install Bundled Python.
Seegcloud topic startupto
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, and start the Google Cloud CLI shell. Uncheck the option to start
the shell. You will run and configure the gcloud CLI in the next steps.
Troubleshooting tips
If your installation is unsuccessful
due to thefindcommand not being recognized, ensure yourPATHenvironment variable is set to include the folder containingfind. Usually,
this isC:\WINDOWS\system32;.
If you uninstalled the gcloud CLI, you must reboot your
system before installing the gcloud CLI again.
If unzipping fails, run the installer as an administrator.
The ten most recent releases are available in the repository. For releases prior to 371.0.0, usegoogle-cloud-sdkas the
package name.
Initialize and authorize the gcloud CLI
If you are behind a proxy or firewall, seeProxy configurationto enable
network access for the gcloud CLI.
After you install the gcloud CLI, initialize it to authorize
access to Google Cloud and set up a default configuration. For more
information, seegcloud init.
Rungcloud initto initialize the gcloud CLI:
gcloudinit
By default, this command opens a web browser to authorize access. To
authorize from the command line instead, add the--console-onlyflag.
For non-interactive authorization,create a service accountwith the
appropriate scopes in theGoogle Cloud console, and then
usegcloud auth activate-service-accountwith its JSON key file.
Follow the prompts to authorize and configure:
When prompted to sign in, accept and then sign in to your Google Account
in your browser. ClickAllowto grant permission to access
resources.
From the list of projects for which you haveOwner,Editor, orViewerpermissions, select a project. If you have only one project,gcloud initselects it for you.
If you have more than 200 projects, you are prompted to enter a project
ID, create a project, or list projects. If you choose to create a
project, you must alsoenable billing on it.
If you have theCompute Engine APIenabled, select a default Compute Engine zone.
Optional: For an improved screen reader experience, enable theaccessibility/screen_readerproperty with the following command:
View information aboutgcloudcommands and other topics:
gcloud help
For example, to view the help forgcloud compute instances create:
gcloud help compute instances create
The gcloud CLI displays a help topic that contains a
description of the command, a list of command flags and arguments, and
examples of how to use the command.
Optional: Install additional components
To install additional components, such as the App Engine emulators,kubectl,
or gcloud CLI commands at the alpha or beta release level, seeManaging gcloud CLI components.
Clean up
To avoid incurring charges to your Google Cloud account for
the resources used on this page, follow these steps.
What's next
Read thegcloud CLI guidefor an overview of
the gcloud CLI, including a quick introduction to key
concepts, command conventions, and helpful tips.
Read thegcloud CLI reference guidefor detailed pages on each gcloud CLI command, including
descriptions, flags, and examples, that you can use to perform a variety of
tasks on Google Cloud.
[[["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-12-15 UTC."],[],[]]
