docs/boxes.md

Boxes

Sizes

sizevCPURAMdiskwho
xs12 GB64 GB NVMeeveryone
s24 GB64 GB NVMeeveryone
m48 GB64 GB NVMeeveryone

Image

Every box runs Ubuntu 26.04.1 LTS (vercel/sandbox/ubuntu) on x86_64 in its own Firecracker microVM. The box user has passwordless sudo and the terminal opens a login shell as root, so the prompt is root@<box>:~#. Apt sources are switched to HTTPS at boot so they work behind the network allowlist.

Sessions

A session lasts the hours you paid, 1 to 24, plus two minutes of grace for the close. extend(box, hours) adds hours to a live session while the total stays at or under 24. When the paid hours run out the keeper closes the box like a stop.

Sleep and wake

Stopping a box snapshots its whole filesystem. Running processes do not survive a stop; files do. One snapshot is kept per box, for 7 days after its last session, and a sleeping box costs nothing.

Caps

25 live boxes in total, read from the Meter (maxLive). One live box per wallet. Raising any cap takes 24 hours onchain; lowering it is instant.

reading the Meter