Skip to main content
Google Cloud Shell is a browser-based command-line environment that gives you instant access to a lightweight VM with the gcloud CLI preinstalled. This guide walks you through launching Cloud Shell, authenticating your session, and verifying access—all without any local setup.

​
Launching Cloud Shell

  1. Sign in to the Google Cloud Console and select your desired project.
  2. Click the Activate Cloud Shell button (terminal icon) in the top-right corner of the console.
Provisioning the Cloud Shell VM can take a few seconds. You’ll see a spinner until the terminal is ready.
  1. When initialization completes, a command prompt appears at the bottom of the console.

​
Authenticating Your Session

Cloud Shell automatically uses your Google account credentials, but you can explicitly log in or refresh your tokens: 
gcloud auth login
This command opens an authorization URL in a separate tab. Follow the prompts to grant Cloud Shell the necessary permissions.
Cloud Shell sessions time out after 120 minutes of inactivity. Be sure to save any important work or scripts to your persistent home directory (~/) before you leave.

​
Verifying Access

Run any gcloud command to confirm that authentication succeeded. For example, list all projects you can access: 
gcloud projects list
If you see a table of project IDs, names, and associated organizations, your Cloud Shell session is fully authenticated and ready for use.

Watch Video