Starting Cloud Shell

This page describes how to start a new Google Cloud Shell session.

Before you begin

Select or create a GCP project.

Go to the Project selector page

Starting a new session

Click the Activate Cloud Shell button at the top of the Google Cloud Platform Console.

Activate Cloud Shell

A Cloud Shell session opens inside a new frame at the bottom of the console and displays a command-line prompt. It can take a few seconds for the shell session to be initialized.

Cloud Shell session

When you start Cloud Shell, g1-small Google Compute Engine virtual machine running a Debian-based Linux operating system is provisioned for you. Cloud Shell instances are provisioned on a per-user, per-session basis. The instance persists while your Cloud Shell session is active and terminates after a hour of inactivity.

Note, that when Cloud Shell is started, the active project in Console is propagated to your gcloud configuration inside Cloud Shell for immediate use. GOOGLE_CLOUD_PROJECT, the environmental variable used by Application Default Credentials library support to define project ID, is also set to point to the active project in Console.

After you have started Cloud Shell, you can start to use the pre-installed tools and commands immediately from the command line. You can also install additional tools in your home directory in persistent disk storage as needed.

Opening multiple sessions

Click the Add Cloud Shell Session Add Session Button button at the top of the Cloud Shell window to open additional sessions. Each session connects to the same virtual machine instance. When you open a new session, it appears in a new tab at the bottom of the console.

Starting Cloud Shell from the gcloud CLI

If you have Google Cloud SDK installed, you can interact with Cloud Shell directly from an existing terminal. Using the gcloud alpha cloud-shell ssh command, you can establish an interactive SSH session with Cloud Shell. With gcloud alpha cloud-shell commands, you can also copy files between your local and Cloud Shell machine via scp, and mount your Cloud Shell directory to your local file system via sshfs. For more detail, see the reference documentation for gcloud alpha cloud-shell.

What's next

Was this page helpful? Let us know how we did:

Send feedback about...

Cloud Shell