Mount storage in Workbench sessions
Workbench sessions can mount external storage volumes so your notebooks and scripts can read and write data on shared file systems. This guide covers attaching PVCs, NFS shares, and CephFS volumes to a session.
Attach PVCs, NFS shares, and CephFS volumes to Workbench sessions.
Mount storage during session creation
Open the new session dialog
Navigate to Workbench and click Sessions, then click + New session.
Configure compute settings
Configure the preset, image, and compute settings as usual.
Configure storage
In the Storage section of the creation dialog:
- Home volume: choose Create new (default ~5 GiB) or Mount existing to attach a PVC you already created.
- Data volumes: click + Add volume to mount additional PVCs, NFS shares, or CephFS volumes. Each volume requires a mount path (for example,
/data/shared). You can set volumes as read-only.
Launch the session
Click Launch session.
The mounted volumes appear at the paths you specified inside your notebook environment.
Success looks like this: the session starts, and the mounted storage is accessible at the configured path inside the notebook or IDE.
Mount storage on an existing session
Edit the session
Open the session detail page and click Edit (the session must be paused first).
Modify storage mounts
In the Storage section, add or remove data volume mounts.
Save and resume
Click Save, then Resume the session.
Storage type considerations
| Type | Best for | Access |
|---|---|---|
| PVC | Single-namespace workloads | Mount path in one session at a time (ReadWriteOnce) or multiple (ReadWriteMany, if supported) |
| NFS | Cross-namespace sharing | Multiple sessions can mount the same share simultaneously |
| CephFS | High-throughput parallel access | Multiple sessions across many nodes |