VESSL Cloud storage
Workspaces come with Temporary storage that disappears when stopped. To keep your data, use persistent storage.
| Storage type | Description | Best for | Mount path |
|---|
| Cluster storage | High-availability distributed storage (CephFS/NVMe) shared across workspaces in the same cluster. Data persists even after workspace termination. | Code, virtualenvs (pip/conda), datasets, team collaboration within a cluster | User-configurable |
| Object storage | S3-backed POSIX-compatible storage accessible from any cluster in your organization | Datasets, checkpoints, large artifacts to share across clusters | /shared (recommended) |
| Temporary storage | Default ephemeral storage included in every workspace | Fast scratch space (data is wiped when stopped) | Varies |
Using Cluster storage
Cluster storage provides fast, persistent storage within a cluster. Multiple workspaces on the same cluster can mount the same volume simultaneously.
How to get started
- Check availability: Go to Cluster storage in the sidebar to see volumes assigned to your team.
- Mount to a workspace: When creating a workspace, select Cluster storage volumes in the Storage step. Choose a mount path (for example,
/root or /data).
- Use it: Access your files at the mount path inside the workspace. Install packages, save checkpoints, and store code — everything persists across workspace restarts and terminations.
Cluster storage volumes can only be created by organization admins. If no Cluster storage is available for your team, contact your admin to set it up. See Manage storage (admin). Key characteristics
- Bound to a cluster: Only workspaces on the same cluster can mount the volume
- Read-Write-Many (RWX): Multiple workspaces can access the same volume simultaneously
- Data persists: Data survives workspace stop, pause, and terminate
- ~150 MB/s throughput: Fast enough for large dataset loading and model checkpoints
- Pricing: $0.20/GiB/month on provisioned capacity. See Storage pricing for details.
Using Object storage
Object storage provides S3-backed storage that can be shared across any cluster in your organization.
How to get started
- Create a volume: Go to Object storage in the sidebar and click New Volume. See Create Object storage volume for details.
- Mount to a workspace: When creating a workspace, select Object storage volumes in the Storage step.
- Use it: Access your files at the mount path (recommended
/shared). Share datasets, checkpoints, and artifacts across teams and clusters.
Object storage is slower than Cluster storage and not suitable as your main workspace path. Do not mount Object storage at /root - use /shared or another separate path instead.
Key characteristics
- Cross-cluster access: Mount from workspaces on any cluster in your organization
- Read-Write-Many (RWX): Multiple workspaces can read and write simultaneously
- S3-backed: Durable, scalable storage
- ~150 MB/s throughput: Suitable for large dataset sharing
- Self-service: Any team member can create Object storage volumes
Key difference:
- Object storage: S3-based, accessible from all clusters. Best for shared datasets, checkpoints, and cross-cluster artifacts.
- Cluster storage: CephFS/NVMe-based, bound to one cluster. Best for code, virtualenvs, package installs, and fast persistent in-Cluster storage.
Which storage should I use?
| Use case | Recommended |
|---|
| Code, virtualenvs, pip/conda packages | Cluster storage |
| Large datasets for training within a cluster | Cluster storage |
| Share data across different clusters | Object storage |
| Long-term backup and archiving | Object storage |
| Quick scratch work (disposable) | Temporary storage |
What changed from Workspace volume?
| Legacy Workspace volume | Cluster storage |
|---|
| Data on terminate | Lost | Preserved |
| Sharing | Single workspace only (RWO) | Multiple workspaces (RWX) |
| Mount path | Fixed to /root | User-configurable |
| Billing | $0.0070/hr per 50 GiB | $0.20/GiB/month |
Migration notice: The legacy “Workspace volume” (per-workspace, RWO) has been replaced by Cluster storage.
If you have existing Workspace volume data, contact support@vessl.ai for migration assistance. Terminology mapping
| Concept | VESSL Cloud term | Kubernetes (typical) | Notes |
|---|
| Cluster-bound shared | Cluster storage | PV/PVC on CephFS (RWX) | Distributed, multi-workspace within cluster |
| Cross-cluster shared | Object storage | PV/PVC on S3/NFS (RWX) | Network file share, any cluster |
| Ephemeral | Temporary storage | emptyDir | Deleted on stop/terminate |
