docs/cli/volume-commands.mdx
Named volumes persist independently of sandboxes and are stored at ~/.microsandbox/volumes/.
msb volume create my-data
msb volume create my-data --size 10G
| Flag | Description |
|---|---|
--size | Storage quota (e.g. 100M, 1G, 10G) |
-q, --quiet | Suppress output (only print the volume name) |
msb volume ls
msb volume ls --format json
msb volume ls -q # Names only
| Flag | Description |
|---|---|
--format | Output format (json) |
-q, --quiet | Show only volume names |
msb volume inspect my-data
msb volume rm my-data
msb volume rm cache-1 cache-2 # Remove multiple
| Flag | Description |
|---|---|
-q, --quiet | Suppress output |
Mount a named volume when creating or running a sandbox. The volume name goes before the colon, the guest path after.
# Create a volume, then mount it
msb volume create app-data --size 5G
msb run --name worker -v app-data:/data python
# Share between sandboxes
msb run --name writer -v shared:/data alpine -- sh -c "echo hello > /data/msg.txt"
msb run --name reader -v shared:/data alpine -- cat /data/msg.txt