> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloud.vessl.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect to a workspace

> Open services in your browser or connect using SSH from your terminal or VS Code.

<Tip>
  **Prefer the terminal?** Run `vesslctl workspace ssh <workspace-slug>` to open the same SSH session straight from your shell. See [`vesslctl workspace ssh`](/cli/commands/workspace#ssh).
</Tip>

## HTTP services

In the workspace detail page, open the **Connect** tab. All HTTP-accessible services—including JupyterLab and any custom ports you opened during workspace creation—are listed here.

* Click the URL to open the service directly in your browser.
* Use the copy button to copy the URL to your clipboard.

## SSH key connection

The **Connect** tab also provides SSH connection details. Two options are available:

* **Connect using SSH**: A one-line command to run directly in your terminal.
* **SSH host setup for VS Code**: An SSH config block to add to `~/.ssh/config` for VS Code Remote-SSH.

<Info>
  SSH keys must be registered in your account settings before connecting. See [SSH keys](/member/settings/ssh-keys) for details.
</Info>

<div>
  <Frame>
    <img src="https://mintcdn.com/dora/nVlXCxn8CeG0iuU_/images/connect_workspace.png?fit=max&auto=format&n=nVlXCxn8CeG0iuU_&q=85&s=ff7693f4057e8a280afe04f2fe0da804" alt="Workspace Connect tab showing HTTP services and SSH key connection" width="1843" height="927" data-path="images/connect_workspace.png" />
  </Frame>

  <small>Example: The Connect tab with HTTP services and SSH connection options</small>
</div>

### Connect from terminal

1. Open the **Connect** tab and select the **Connect using SSH** tab.
2. Click the copy icon to copy the SSH command.
3. Replace `/path/to/<key-name>` with the actual path to your private key file (usually in `~/Downloads`).
4. Paste and run the command in your terminal.

### Connect using VS Code Remote-SSH

1. Install the VS Code extension **Remote-SSH**.
2. Open the **Connect** tab and select the **SSH host setup for VS Code** tab.
3. Click the copy icon to copy the SSH config block.
4. Paste the block into your `~/.ssh/config` file.
5. Replace `/path/to/<key-name>` with your downloaded private key path (usually in `~/Downloads`).
6. In VS Code, open the Command Palette and run `Remote-SSH: Connect to Host...`, then select the workspace name.

Example `~/.ssh/config` entry:

```sshconfig theme={null}
Host <workspace-name>
  HostName capella.cloud.vessl.ai
  IdentityFile /path/to/<key-name>
  Port 32154
  User root
```

<div>
  <Frame>
    <img src="https://mintcdn.com/dora/2ziDQ03HNyX-cCOE/images/vscodeaddhost.png?fit=max&auto=format&n=2ziDQ03HNyX-cCOE&q=85&s=e4e068a041b7e8127da75853aa0bb2d0" alt="VS Code Remote-SSH add host screen" width="1252" height="140" data-path="images/vscodeaddhost.png" />
  </Frame>
</div>

<div>
  <Frame>
    <img src="https://mintcdn.com/dora/7Ws2c2n6NBGiq46P/images/vscode_sshhost.png?fit=max&auto=format&n=7Ws2c2n6NBGiq46P&q=85&s=4870fedb79afd39ab1be1ef99e571ecc" alt="VS Code Remote-SSH host connection screen" width="904" height="188" data-path="images/vscode_sshhost.png" />
  </Frame>
</div>

<Tip>
  If you experience input latency in the remote terminal, enable VS Code's **local echo** feature. It displays your keystrokes immediately before the remote server confirms them. Turn it on in [terminal.integrated.localEchoEnabled](vscode://settings/terminal.integrated.localEchoEnabled). See [Reducing remote input latency](https://code.visualstudio.com/docs/terminal/advanced#_reducing-remote-input-latency-preview) for details.
</Tip>