Manage Volumes

Use nullspace volume ... to manage durable shared filesystems without starting a machine. Use nullspace machine create --volume ... to mount a volume into a new machine.

Create And Inspect

nullspace volume create team-data
nullspace volume list
nullspace volume list --fields id,name,mount_count,used_bytes
nullspace volume get team-data
nullspace volume get team-data --fields id,status,max_size_bytes

volume get accepts a volume ID such as vol_... or an exact volume name. --fields returns compact metadata for scripts.

Mount Into A Machine

nullspace machine create \
  --template base \
  --volume ref=team-data,mount=/data

Mount a subdirectory read-only:

nullspace machine create \
  --template base \
  --volume ref=team-data,mount=/models,subpath=/published-models,ro=true

ref can be a volume name or ID. mount must be an absolute machine path. subpath is resolved inside the volume. ro=true makes the machine mount read-only, but callers with API access can still modify the volume through direct nullspace volume ... commands. The CLI currently supports create-time volume mounts. Use the Python SDK or HTTP API to attach, detach, check health, or remount a volume on an already running machine. Destroying a machine releases its remaining volume attachments. nullspace machine hibernate releases live mount leases while stopped, but preserves attachment intent and remounts the same volumes on resume.

Read And Write Direct Files

Direct volume file paths are volume-internal absolute paths rooted at /.

nullspace volume ls-files team-data /
nullspace volume cat team-data /README.md
nullspace volume read team-data /models/manifest.json
nullspace volume read team-data /models/model.bin --encoding base64
printf "hello\n" | nullspace volume write team-data /hello.txt
printf 'Zm9vCg==' | nullspace volume write team-data /foo.txt --encoding base64

Write many small files with JSON or @file.json:

nullspace volume write-files team-data '[["/a.txt","a\n"],["/b.txt","b\n"]]'
nullspace volume write-files team-data @files.json

Manage Paths

nullspace volume exists team-data /models/model.bin
nullspace volume info team-data /models/model.bin
nullspace volume stat team-data /models/model.bin
nullspace volume mkdir team-data /models
nullspace volume mv team-data /models/old.bin /models/new.bin
nullspace volume chmod team-data /models/new.bin 0644
nullspace volume rm team-data /tmp/old.bin

exists exits with status 0 when the path exists and 1 when it does not. info and stat both return metadata JSON.

Search, Replace, And Watch

nullspace volume find team-data /models "weights"
nullspace volume search team-data /models "*.bin"
nullspace volume replace team-data "old" "new" /models/config.json --dry-run
nullspace volume watch team-data /models --recursive --timeout 30

find searches file contents. search matches file names. replace returns a structured replacement result, including dry-run details. watch streams JSON events until interrupted or until --timeout expires.

Upload And Download

nullspace volume upload team-data ./model.bin /models/model.bin
nullspace volume upload team-data ./models /models --concurrency 4
nullspace volume upload team-data ./models /models --conflict merge --exclude '*.tmp'
nullspace volume upload team-data ./large.bin /models/large.bin \
  --resumable always \
  --checksum auto \
  --concurrency 4

Resume a failed upload with the reported upload ID:

nullspace volume upload team-data ./large.bin /models/large.bin --resume upload_123

Download files or directories:

nullspace volume download team-data /models/model.bin ./model.bin --force
nullspace volume download team-data /datasets ./datasets-copy --force
nullspace volume download team-data /datasets ./datasets.tar --archive --force --json

--force overwrites an existing local destination. Directory downloads extract by default; --archive keeps the downloaded tar archive.

Signed URLs

nullspace volume upload-url team-data /models/model.bin
nullspace volume download-url team-data /models/model.bin
nullspace volume download-url team-data /datasets --archive-format tar

Use signed URLs when a browser, CI job, or another service should transfer data directly.

Delete

nullspace volume delete vol_12345678

Delete by volume ID. Deleting an attached volume can be rejected; destroy attached machines before retrying. Hibernating a machine is not a volume detach operation because the attachment remounts on resume.

Python SDK

Python SDK objects

TypeScript SDK

CLI

Platform reference

Create And Inspect

Mount Into A Machine

Read And Write Direct Files

Manage Paths

Search, Replace, And Watch

Upload And Download

Signed URLs

Delete

​Create And Inspect

​Mount Into A Machine

​Read And Write Direct Files

​Manage Paths

​Search, Replace, And Watch

​Upload And Download

​Signed URLs

​Delete

​Related

Create And Inspect

Mount Into A Machine

Read And Write Direct Files

Manage Paths

Search, Replace, And Watch

Upload And Download

Signed URLs

Delete

Related