gcloud cloud-shell ssh

NAME

gcloud cloud-shell ssh - allows you to establish an interactive SSH session with Cloud Shell

SYNOPSIS

gcloud cloud-shell ssh [--authorize-session] [--command=COMMAND] [--dry-run] [--force-key-file-overwrite] [--ssh-flag=SSH_FLAG] [--ssh-key-file] [GCLOUD_WIDE_FLAG …]

DESCRIPTION

gcloud cloud-shell ssh lets you remotely log in to Cloud Shell. If your Cloud Shell is not currently running, this will cause it to be started before establishing the SSH session.

EXAMPLES

To SSH into your Cloud Shell, run:

gcloud cloud-shell ssh

To run a remote command in your Cloud Shell, run:

gcloud cloud-shell ssh --command=ls

FLAGS

--authorize-session

If provided, sends OAuth credentials to the current Cloud Shell session on behalf of the user. When this completes, the session will be authorized to run various Google Cloud command-line tools without requiring the user to manually authenticate.

--command=COMMAND

A command to run in Cloud Shell. Runs the command in Cloud Shell and then exits.

--dry-run

If provided, prints the command that would be run to standard out instead of executing it.

--force-key-file-overwrite

If enabled gcloud will regenerate and overwrite the files associated with a broken SSH key without asking for confirmation in both interactive and non-interactive environment. If disabled gcloud will not attempt to regenerate the files associated with a broken SSH key and fail in both interactive and non-interactive environment.

--ssh-flag=SSH_FLAG

Additional flags to be passed to ssh(1).

--ssh-key-file

The path to the SSH key file. By default, this is ~/.ssh/google_compute_engine.

GCLOUD WIDE FLAGS

These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, --help, --impersonate-service-account, --log-http, --project, --quiet, --trace-token, --user-output-enabled, --verbosity.

Run $ gcloud help for details.

NOTES

These variants are also available:

gcloud alpha cloud-shell ssh

gcloud beta cloud-shell ssh

Except 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 2026-06-09 UTC.

gcloud cloud-shell ssh Stay organized with collections Save and categorize content based on your preferences.

gcloud cloud-shell ssh