Skip to main content

​
Quick demo

Explore the new workspace creation flow with the quick demo below.

​
Step-by-step guide

The workspace creation process is split into three steps to help you configure your environment more easily.

​
Step 1: Select resource

Choose your hardware specifications and basic settings.
Step 1: Select resource screenshot
1

Workspace name

Enter a name for your workspace.
2

Select resource spec

Browse and select the hardware specification (GPU/CPU) that best fits your needs. VESSL automatically assigns the optimal cluster for your selected resource. You can view the estimated hourly cost in each spec card.

​
Step 2: Deployment settings

Set up your environment, including image, SSH key, ports, and storage.
1

Container image

Step 2: Image and SSH Key settings
Select a pre-configured official image (like PyTorch, CUDA) or use your own custom image.
When using a custom image, ensure that SSH server (SSHD) and Python are installed to enable connectivity and full functionality.
2

SSH key

Select an existing SSH key or generate a new one directly here.
  • Generate SSH Key: Click to create a new key pair instantly. The private key will be downloaded, and the public key saved to your settings.
3

Port (New)

Step 2: Advanced settings (Ports)
You can now open Custom Ports to access specific services running in your workspace.
  • Click Add port to define ports you need to expose (for example, HTTP, TCP).
4

Persistent volume

Step 2: Persistent Volume settings
In the Deployment settings step, attach at least one workspace volume or shared volume to preserve data.
Workspaces include temporary storage that disappears when stopped. Add a persistent volume to keep your data while working.
Recommended paths:
  • Workspace volume mount path is fixed to /root ($HOME) and cannot be changed.
    • In the UI, the path field is disabled and shows a message like: Your workspace volume is mounted at /root ($HOME).
  • Mount shared volume at /shared (object storage for datasets).

​
Step 3: Review

Review your settings and launch the workspace.
Step 3: Review screenshot
1

Pricing summary

Check the total estimated hourly cost based on your selected resource and volumes.
2

Deploy

Click Deploy to create and 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.

​
Persistent volume types

TypeDescriptionMax per workspace
Workspace volume1:1 dedicated persistent volume for the workspace1
Shared volumeTeam-shared, S3-backed POSIX-compatible volumeMultiple
You can attach one workspace volume and multiple shared volumes simultaneously.
See also: Volume list for team-assigned shared volumes and usage details.