The microVM is the compute; the SandFS is the disk. Each agent owns one or more SandFS instances — everything it keeps lives here.
Flat — the build mode
chroot /mnt/rootfs — the whole volume, read-write
├─ template files → writable copy — /usr /etc /bin all persist
├─ /workspace → plain dir in the volume (cwd)
├─ /home/agent → plain dir in the volume
└─ /tmp → plain dir in the volume — persists
apt / yum work — 10 ambient caps
- seeded from local or OCI template
- freeze → becomes a new template
Overlay — the serve mode
chroot /mnt/rootfs
├─ template files → read-only overlay (kernel-enforced)
├─ /workspace → writable bind → volume
├─ /home/agent → writable bind → volume
└─ /tmp → fresh tmpfs — node-local, never shared
- no upperdir/workdir → runs on any shared FS
- layers extracted once, shared by all instances
- zero capabilities — Strict profile
① build flat template — chroot-able rootfs, offline
→
② agent builds — flat SandFS · apt / pip
→
③ freeze — save-as-template → read-only base
→
④ publish — OCI artifact (optional, cross-site)
→
⑤ serve — overlay ×N · shared base + private workspace
- Persists across swaps, VM recycle, node migration —
pip / npm / files all survive
- overlay SandFS: detach / attach template — swap the read-only base without losing agent work (
workspace/ · home/ live in the volume)