Docs

Volumes

Extra storage that outlives your machines: mounted at /mnt, billed on the data it holds, apart from the machine's own disk.

Two kinds of storage

Machine diskVolume
What it isThe machine's own disk, /workspace includedExtra storage, mounted at /mnt
What it costsPart of the GPU price$0.15 per GB-month of data it holds, charged daily
How long it's keptDeleted with the machineUntil you delete it
SpeedLocal disk, the fastestNetwork storage: good for loading and saving, slower for many small reads

Make one and use it

  1. In the Rent sheet, pick New volume… under Volume and name it, or make one first on Volumes.
  2. The machine starts with the volume at /mnt. Keep datasets, weights and checkpoints there.
  3. The machine keeps that volume until it's removed. One volume can be on several machines at once: they all see the same files, and the last write wins.

Machines marked No volume in Find GPUs can't mount one, and the sheet says so. A volume can't be deleted while a machine has it mounted.

What it costs

  • $0.15 per GB-month of data the volume holds. It's measured once a day and charged daily from your balance, so 100 GB kept for a month costs $15, and an empty volume costs nothing.
  • Reads are included up to the data the volume holds, each month: a volume holding 100 GB includes 100 GB of reads. Writing to it is always included.
  • Reads well beyond that may be charged at $0.10 per GB. We'll tell you before we do.
  • The machine's own disk costs nothing extra: it's part of the GPU price.
  • A volume's charge is owed even when the balance is short, and a new volume needs money in the account. Delete a volume you no longer need: it's charged until you do.

Keep reads down

Every copy from /mnt counts as a read. Copy what a run reads over and over (a dataset, model weights) to the machine's disk once, and write results back to /mnt as they finish:

Shell
cp -r /mnt/datasets /workspace/

From the CLI and API

Shell
arrakis volumes create --name datasets
arrakis instances create --node-id <node> --volume-id <volume id> --termination-hours 4
arrakis volumes list

POST /v1/volumes makes a volume, and volume_id on POST /v1/instances mounts it. GET /v1/gpus?volumes=true lists only machines that take one. GET /v1/volumes shows what each volume holds, what it costs a month at that, and the machines it's on.

Reading this as an agent? This page as Markdown.