Skip to main content

​
Jupyter

In the workspace detail page, open the Connect tab. You can access the Jupyter notebook using the port shown there.
Workspace open Jupyter screenshot
  • Click the port number or Open Jupyter to open the session directly in your browser.
  • No additional setup is required.

​
SSH

Run the command below to connect to your workspace using SSH. Replace /path/to/<key-name> with your private key path.
Workspace SSH connection screenshot

​
Connect from terminal

  1. In the workspace detail page, open the Connect tab and locate the SSH command.
  2. Click the copy icon to copy the SSH command to your clipboard.
  3. Replace /path/to/key with the actual path to your private key file.
  4. Paste and run the command in your terminal.
SSH keys must be registered in your account settings before connecting. See SSH keys for details.

​
Connect using VS Code Remote-SSH

If you prefer working in VS Code, you can connect using the Remote - SSH extension.
  1. Install the VS Code extension Remote - SSH.
  2. In the workspace detail page, open the Connect tab and copy the SSH command.
  3. In VS Code, open the Command Palette and run Remote-SSH: Add New SSH Host....
  4. Paste the SSH command.
  5. Replace the private key path after -i with the actual path to your downloaded private key file.
  6. Select your SSH config file when prompted (usually ~/.ssh/config).
  7. Run Remote-SSH: Connect to Host... and select the host you just added.
VS Code Command Palette: Remote-SSH Add New SSH Host
When adding multiple workspaces on the same cluster, the HostName (hostname/domain) can be the same (for example, capella.cloud.vessl.ai). In that case, VS Code may create duplicate entries in ~/.ssh/config. To prevent this, make sure each workspace has a unique Host (alias), for example by appending the workspace name (like capella.cloud.vessl.ai-<workspace_name>). Keep HostName as the real hostname/domain, and use the workspace-specific Port from the copied command.
SSH config example without unique Host alias
SSH config example with unique Host alias suffix
Example ~/.ssh/config entries: 
Host capella.cloud.vessl.ai-<workspace_name>
  HostName capella.cloud.vessl.ai
  User root
  Port 32154
  IdentityFile /your/local/path/to/<key-name>

Host capella.cloud.vessl.ai-<workspace_name_2>
  HostName capella.cloud.vessl.ai
  User root
  Port 38712
  IdentityFile /your/local/path/to/<key-name>

​
Custom ports

If you opened Custom Ports during workspace creation, you can find their connection information in the workspace detail page’s Connect tab.
  • Internal Port: The port your service is listening on inside the workspace.
  • External Link/Port: The public address you can use to access the service.
Click the link or use the provided address to connect to your custom applications.