docs/boxes.md
Boxes
Sizes
| size | vCPU | RAM | disk | who |
|---|---|---|---|---|
| xs | 1 | 2 GB | 64 GB NVMe | everyone |
| s | 2 | 4 GB | 64 GB NVMe | everyone |
| m | 4 | 8 GB | 64 GB NVMe | everyone |
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.