Global volumes for Pods are in beta. Features and behavior may change before general availability.
Attach a global volume to a Pod
You can attach a global volume when deploying a new Pod using either of the following methods.- From Storage: Click your global volume, then click Configure Pod with volume. This opens the Pod deployment page with the volume already attached.
- During Pod deployment:
- Go to Pods and click + Deploy.
- Select a template and GPU. You must select a GPU before you can attach storage.
- Scroll to the Storage section.
- Under Persistent storage, click + Add volume.
- Select your volume from the list. Global volumes appear first with a Global badge, followed by network volumes labeled with their data center. To create a new global volume here instead, click + Create volume.
- Click Deploy Pod.
Mount paths
The mount path is set at deploy time and does not change while the Pod is running. A global volume defaults to/workspace. If you add a network volume during deployment without changing the global volume’s mount path, the deploy flow automatically shifts the global volume to /workspace-global so both volumes can be mounted without conflict. The network volume then mounts at /workspace.
If you edit the global volume’s mount path field during deployment (rather than leaving the default), the network volume is assigned /workspace-2 instead.
You can verify the volume is mounted by running ls on the mount path from the Pod’s Console tab. For example, if your global volume is at /workspace-global:
Limitations
- One volume of each type per Pod: Each Pod supports a maximum of one global volume and one network volume at a time.