Skip to main content

​
Quick demo

Explore the workspace creation flow with the quick demo below.

​
Overview

All workspace settings are configured on a single page. Fill in each section and click Create to launch your workspace.
Create workspace page showing all configuration sections

​
Workspace name

Enter a name for your workspace. A random name is generated by default.

​
Resource spec

Browse and select the hardware specification (GPU/CPU) that best fits your needs.
  • Use the GPU Type, Volume, and Region filters to narrow down available specs.
  • Each spec card shows the hourly cost, availability status, VRAM, vCPU count, and temporary storage size.
  • VESSL Cloud automatically assigns the optimal cluster for your selected resource.
Each spec card shows an availability indicator:
  • High: Sufficient resources available — your workspace should start promptly.
  • Low: Limited resources available — your workspace may wait in queue longer than usual.
  • Checking: Availability data is temporarily unavailable. Refresh the page to reload.
Resource spec cards showing GPU availability indicators

​
Persistent volume

Add a persistent volume to keep data across restarts and share it with your team.
  • Select a Volume from the dropdown and specify a Mount Path.
  • Click Add volume to attach additional volumes.
Workspaces include temporary storage that disappears when stopped. Attach a persistent volume to keep your data.
Recommended paths:
  • Cluster storage: Mount at /root ($HOME) for code/environments, or a custom path like /data.
  • Object storage: Mount at /shared (recommended for datasets and cross-cluster sharing).

​
Storage types

TypeDescriptionMax per workspace
Cluster storageHigh-availability distributed storage (CephFS/NVMe) shared within the same cluster. Data persists after terminate.Multiple
Object storageS3-backed POSIX-compatible storage accessible across all clustersMultiple
You can attach multiple cluster storage and object storage volumes to a single workspace.
See also: Storage list for available storage volumes and usage details.

​
Container image

Select a pre-configured official image (like PyTorch, CUDA) or switch to the Custom tab to use your own image.
When using a custom image, ensure that SSH server (SSHD) and Python are installed to enable connectivity and full functionality.

​
SSH keys

Select an existing SSH key or click Generate SSH Key to create a new key pair.
  • The private key will be downloaded to your machine, and the public key is saved to your account automatically.

​
Advanced settings

Toggle Advanced settings to configure ports and initialization scripts.

​
Ports

Default ports are pre-configured:
  • HTTP 8888 — JupyterLab
  • TCP 22 — SSH
Click Add port to expose additional custom ports (HTTP or TCP).

​
Init script

Add shell commands that run automatically when the workspace starts. Useful for installing dependencies or setting up your environment.

​
Pricing summary and create

The Pricing summary panel on the right shows the selected resource spec details (VRAM, vCPU, RAM) and the estimated hourly cost.
Pricing summary showing resource details and Create button
Click Create to launch your workspace.
Credit buffer: Workspaces will not be terminated until your balance drops below -$10. This buffer amount will be displayed as a negative balance on your credit badge and deducted from your next top-up.