Workspace SSH approaches
There are two ways to access a workspace via SSH using an SSH key or an Access Token.

Copy SSH key from modal
- SSH Key (recommended) - By creating your own public/private SSH key pair, and uploading the public key to Gitpod you can directly SSH into a Gitpod workspace. Uploading a public key means that you do not need to keep re-visiting the Gitpod dashboard to retrieve an SSH command. It is also a more secure approach. See configure SSH for more.
- Access Token - Alternatively, you can access a workspace using the copy/paste SSH command. This approach uses an access token which is reset on every workspace start. This approach is useful for quick SSH access, or when installing an SSH key locally is not possible, such as on some devices.
SSH key Access
You must upload a public key to Gitpod before you can access your workspace
using an SSH key. See configure SSH for
more.
- Visit your workspace list in Gitpod
- View a running Gitpod workspace and click the more actions menu
- Select “connect via SSH”
- Copy paste the selected command


Accessing an SSH key from the workspace list


SSH Key access via modal


SSH to a workspace via the workspace splash page
Access Token SSH
You can currently copy/paste a simple SSH command to get command line access to your workspace from the Gitpod dashboard.- Visit your workspace list in Gitpod
- View a running Gitpod workspace and click the more actions menu
- Select “connect via SSH”
- Navigate to the “Access Token” tab
- Copy paste the selected command


Accessing an SSH key from the workspace list


SSH via access token from the workspace list


SSH to a workspace via the workspace splash page
SSH via Local Companion
It is possible to access your Gitpod workspaces via the command line using
local companion, however
access using an SSH key is the preferred approach.