Using the Google Cloud SDK installer

Cloud SDK provides an installer for each supported platform. It can be deployed either interactively or non-interactively.

Interactive installation

The installer lets you download, install and set up the latest version of Cloud SDK quickly in an interactive mode. When you run the installer, it downloads Cloud SDK components and installs them on the local system. It also performs additional setup tasks like adding Cloud SDK components to your PATH and enabling command completion in your shell.

Linux and macOS
  1. Enter the following at a command prompt:
    curl | bash
  2. When prompted, choose a location on your file system (usually your Home directory) to create the google-cloud-sdk subdirectory under.
  3. If you'd like to add Cloud SDK command-line tools to your PATH and enable command completion, answer y when prompted.
  4. Restart your shell:
    exec -l $SHELL
  5. Run gcloud init to initialize the gcloud environment:
    gcloud init
Windows (Installer)
  1. Download the Cloud SDK installer.

    Alternatively, open a PowerShell terminal and run the following PowerShell commands.

    (New-Object Net.WebClient).DownloadFile("", "$env:Temp\GoogleCloudSDKInstaller.exe")
    & $env:Temp\GoogleCloudSDKInstaller.exe

  2. Launch the installer and follow the prompts. The installer is signed by Google LLC.

    If you'd like to enable screen reader mode, select the Turn on screen reader mode option for a more streamlined screen reader experience. To read more about the Cloud SDK screen reader experience, refer to the Accessibility features guide.

    Google Cloud SDK Setup welcome dialog for Windows with checkbox for enabling screen reader mode

  3. Cloud SDK requires Python; supported versions are Python 3 (preferred, 3.5 to 3.8; the installer comes with Python 3 bundled by default) and Python 2 (2.7.9 or higher). Your operating system must be able to run one of these supported Python versions in order for Cloud SDK to run.

    The installer installs all necessary dependencies, including the needed Python version. While Cloud SDK currently installs and manages Python 3 by default, you can use an existing Python installation if necessary by unchecking the option to Install Bundled Python.

  4. After installation has completed, the installer presents several options:

    Windows installer prompts

    Make sure that the following are selected:

    • Start Google Cloud SDK Shell
    • Run gcloud init

    The installer starts a terminal window and runs the gcloud init command.

  5. The default installation does not include the App Engine extensions required to deploy an application using gcloud commands. These components can be installed using the Cloud SDK component manager.
Troubleshooting tips:
  • If your installation is unsuccessful due to the find command not being recognized, ensure your PATH environment variable is set to include the folder containing find. Usually, this is C:\WINDOWS\system32;.
  • If you have just uninstalled Cloud SDK, you will need to reboot your system before installing Cloud SDK again.
Windows (Zip)

You can also install the latest version from a downloaded .zip file:

  1. Download and extract its contents. (Right click on the downloaded file and select 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:

    C:\> gcloud init

Non-interactive (silent) deployment

You can automate Cloud SDK installation using the installer non-interactively.

For Linux and MacOS:

Save the install script locally instead of piping it to bash.

  1. Enter the following at a command prompt:
    curl >
  2. Run the script, passing arguments described below, for example
    bash --disable-prompts
  • --disable-prompts - disable prompts.

  • --install-dir=DIRECTORY - set the installation root directory to DIRECTORY. The Cloud SDK will be installed in DIRECTORY/google-cloud-sdk. The default is $HOME.

For Windows:

  • /S - install silently. No installer pages are displayed. Use flags to change install settings.
  • /D - set the default installation directory. It must be the last parameter used in the command line and must not contain any quotes, even if the path contains spaces. Only absolute paths are supported, for example /D=C:\CloudSDK
  • /allusers - install for all users
  • /singleuser - install for current user (default)
  • /screenreader - turn on screen reader mode (default is to turn it off)
  • /reporting - enable usage reporting (default is to turn off usage reporting)
  • /noreporting - disable usage reporting (default is to turn off usage reporting)
  • /nostartmenu - don't create start menu shortcut (default is to create shortcut)
  • /nodesktop - don't create desktop shortcut (default is to create shortcut)

Try it for yourself

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 free