Shared Volume

Volumes are durable storage that outlives any machine and can be mounted into several at once. This example creates a volume, mounts it read-write in one machine and read-only in another, and shows a write flowing between them.

Requires a deployment with the shared-volume backend enabled (the hosted private beta has it).

Setup

uv pip install "nullspace-sdk==1.0.0"
export NULLSPACE_API_KEY=ns_live_...
export NULLSPACE_API_URL=https://api.your-nullspace-domain

Python

shared_volume_example.py

import uuid

from nullspace import Machine, Volume, VolumeMount

volume = Volume.create(f"shared-{uuid.uuid4().hex[:8]}")
writer = reader = None
try:
    writer = Machine.create(
        template="base", timeout=120,
        volumes=[volume.mount("/workspace/shared")],
    )
    reader = Machine.create(
        template="base", timeout=120,
        volumes=[VolumeMount(ref=volume.name, mount_path="/workspace/shared",
                             read_only=True)],
    )

    writer.files.write("/workspace/shared/hello.txt", "hello from shared volume\n")
    print("reader saw:", reader.files.read("/workspace/shared/hello.txt").strip())
finally:
    for machine in (writer, reader):
        if machine is not None:
            machine.kill()
    volume.delete()

Expected output

reader saw: hello from shared volume

Writes land in the volume, not the machine rootfs — destroy both machines and the data stays until volume.delete(). The read-only mount makes the reader’s side of the tree immutable; writes there fail with a permission error. Related: Volumes overview · Mounting volumes

Template Warm Pools GitHub Actions CI/CD

Overview

Machine patterns

Networking and access

Agent deployments

Setup

Python

Expected output

​Setup

​Python

​Expected output

Setup

Python

Expected output