Notebook Volumes
The Volumes section of the BioLM Console provides persistent storage that can be attached to your Notebook Sessions.
Volumes act as personal or shared data directories within your workspace, making it easy to save notebooks, datasets, and intermediate results that persist across sessions.
Overview
Volumes are lightweight storage mounts that integrate directly with the Jupyter environment.
Each Volume is automatically made available at runtime under:
/home/biolm/workspace/volumes/<volume-name>
You can use Volumes to:
- Store experiment results, datasets, and scripts
- Share files across multiple sessions or team members
- Keep data accessible between short-lived Jupyter environments
Volumes are free to use and belong to the selected workspace Environment.
Creating a New Volume
- Navigate to the Volumes page in your workspace.
- Enter a Display Name and optional Description.
- Click Create to generate the new Volume.
The Volume will appear under Your Volumes, showing:
- Display name and mount path
- Owner information
- Access level (personal or organization-wide)
You can rename or delete any Volume at any time.
Attaching Volumes to Notebook Sessions
When creating a new Notebook Session, you can attach one or more Volumes for data persistence:
- Click + New Session under the Jupyter tab.
- In the Attach Volumes section, check the boxes next to the Volumes you want to mount.
- Click Create Session.
Within JupyterLab, attached Volumes appear automatically under the /volumes/ directory.
Any files saved there remain accessible across sessions, environments, and collaborators with access permissions.
Managing Volumes
The Your Volumes list displays all storage mounts available in your current workspace.
Each Volume entry includes:
- Path – the internal mount directory
- Description – optional label for identifying content
- Owner – the creator or workspace administrator
- Access Level – indicates whether the Volume is private or shared
You can rename Volumes inline or delete them when no longer needed.
Working with Volumes in JupyterLab
Once a Volume is attached, you can:
- Open, edit, and save files directly within
/volumes/<name>/ - Write analysis outputs, model checkpoints, or logs to persistent storage
- Access the same Volume across multiple sessions or by different users in shared workspaces
Changes made in Volumes are automatically saved to your workspace storage and remain after the session ends.
Notes
- Volumes are environment-specific but can be reused across multiple sessions within that environment.
- Deleting a Volume permanently removes all files stored inside it.
- Attached Volumes remain persistent even after their linked sessions are terminated.
- Each workspace may contain multiple Volumes for organizing different datasets or projects.