# Launch Cloud Shell

A Cloud Shell session can be launched in different ways to best fit
your use case.

## Launch from the Google Cloud console

To launch a Cloud Shell session from the Google Cloud console,
click
![Activate Shell Button](https://docs.cloud.google.com/static/shell/docs/images/activate_cloud_shell.svg)
**Activate Cloud Shell** in the
[Google Cloud console](http://console.cloud.google.com). This launches a
session in the bottom pane of Google Cloud console.

You can also transfer this session to a full screen experience by clicking
![Open in new window button](https://docs.cloud.google.com/static/shell/docs/images/open-new-tab.png)
**Open in new window**.

## Launch a standalone session

If you'd prefer a standalone session, you can launch a
Cloud Shell session with
[shell.cloud.google.com](https://shell.cloud.google.com). The
Cloud Shell terminal and Cloud Shell Editor are
automatically started for you.

To open just the Cloud Shell Editor, you can use
[ide.cloud.google.com](https://ide.cloud.google.com). You can still access the
Cloud Shell terminal at any time using the Open
terminal button
![Activate Shell Button](https://docs.cloud.google.com/static/shell/docs/images/activate_cloud_shell.svg)
in the
Cloud Shell menu bar.

## Launch from documentation

<br />

After starting your [free trial](https://console.cloud.google.com/freetrial), you can find ![Activate Cloud Shell
button](https://docs.cloud.google.com/static/shell/docs/images/activate-cloud-shell-button.svg) **Activate Cloud Shell** in the header of the documentation page you're on. If you're signed into your Google account and reading Google Cloud documentation, you can find ![Activate Cloud Shell
button](https://docs.cloud.google.com/static/shell/docs/images/activate-cloud-shell-button.svg) **Activate Cloud Shell** in the header of the documentation page you're on.

<br />

![Cloud Shell terminal launched within the bottom half of the documentation page with a gcloud command example copied into the Cloud Shell terminal](https://docs.cloud.google.com/static/shell/docs/images/launch-within-docs.png)

This button launches the Cloud Shell as a panel at the
bottom of your current page. You can then experiment with the product you're
reading about while keeping the product's documentation in context.

The Cloud Shell terminal comes with the
gcloud CLI, Docker, and
[other command-line utilities](https://docs.cloud.google.com/shell/docs/how-cloud-shell-works#tools)
preinstalled and automatically authenticates you with your Google credentials,
so you can use the terminal to run sample code in the documentation. This means
that you can enable and experiment with Cloud APIs, start long-running
operations, and manage your Google Cloud resources from the
command line without leaving documentation.

## Launch with an Open in Cloud Shell link

If you'd like your users to experiment with your project or code samples without
having to download the gcloud CLI or installing dependencies, use
the [Open in Cloud Shell](https://docs.cloud.google.com/shell/docs/open-in-cloud-shell) (OiCS)
feature. This feature allows you to construct and publish a URL that
automatically performs certain actions upon Cloud Shell launch,
such as cloning a Git repository or opening a tutorial. This option has the
added advantage of allowing you to customize the launched
Cloud Shell experience by supporting the inclusion of URL
parameters when crafting an OiCS link.

## Launch and connect locally to Cloud Shell with the gcloud CLI

If you'd like to interact with and connect to your Cloud Shell
environment using a local command-line, you'll need to
[install the gcloud CLI](https://docs.cloud.google.com/sdk/install). Using the
gcloud CLI, specifically the
[`gcloud cloud-shell`](https://docs.cloud.google.com/sdk/gcloud/reference/cloud-shell) command group, you
can copy files between your local machine and Cloud Shell
environment and establish an interactive SSH session with
Cloud Shell.