Storage

Storage keeps data independently of sandboxes. Upload large data once, then let any number of sandboxes work on it.

nido storage put ./data my-data   # creates my-data and uploads the folder
nido storage ls                   # your volumes with file count and size
nido storage ls my-data           # the files in one volume
nido storage rm my-data           # deletes the volume and all its files

Files go straight from your machine to our storage in the EU, not through a sandbox. Running put again adds files and overwrites files with the same path. rm refuses while a sandbox, even a stopped one, uses the volume: remove the sandbox first.

Use a volume in a sandbox

A sandbox gets a volume at /data/<name>. Add it to x-nido:

---
x-nido:
  command: python3 analyze.py /data/my-data
  storage: [my-data]
---

Or directly: nido create scratch --storage my-data. Volumes are attached when a sandbox is created, so after changing storage run nido run --fresh. The sandbox reads and writes the volume directly, without copying. What it writes there stays after the sandbox is gone.

GPU sandboxes cannot attach volumes yet; see Training.