Limitations
Spinbox is experimental. APIs will change, and data may be lost. What is built, what is partly there and what is not built yet is the status page, written from the tree by a test. This page is the limits: what Spinbox does not do by design, or by where it runs today. Each bullet here is a limit row of that same list, and the build fails when the two disagree.
Where it runs
Section titled “Where it runs”- AWS only. The module in spin-terraform-aws is the supported way to install Spinbox. The platform itself is not tied to AWS, but nothing else is packaged or tested.
- x86-64 only. Runners are x86-64 machines with nested virtualization. There are no Arm runners.
- The CLI runs on Linux and macOS. x86-64 and Arm of each; there is no Windows build.
- One region, one control plane. An installation lives in one AWS region. The control plane and the proxy are each a single machine; an update replaces them without stopping workspaces, but a machine that fails is replaced in minutes, not seconds.
Workspaces
Section titled “Workspaces”- No GPUs. A preset names the class of runner its workspaces run on, and no class hands a workspace a GPU.
- Linux guests only. Booted with the kernel Spinbox provides.
- No IPv6 inside a workspace. The resolver a workspace uses drops AAAA answers.
- TCP only for published ports.
- A diff does not see everything. It hashes a file only when its size, inode or times changed, so a change hidden by setting the times and the clock back is not reported. Extended attributes are not compared.
- A memory snapshot resumes only on the same machine. It needs a runner carrying the same QEMU, guest kernel and guest init as the one it was taken on. A disk restore has no such limit.
- Disk chains have a limit. A disk is a chain of layers. A workspace that runs for a very long time without stopping stops adding layers at the limit, and its top layer grows instead, so less of its recent work is in the bucket.
Durability
Section titled “Durability”- Work since the last upload can be lost. A runner uploads a workspace’s writes in layers: on the installation’s RPO, on snapshot and on stop. If the runner is lost, what it had not uploaded is lost with it. See How it works.
Identity and access
Section titled “Identity and access”- No multi-factor authentication of Spinbox’s own. Sign in through GitHub or an OIDC provider that enforces it.
- No team invitations. A person must sign in once before they can be added to a team. A workspace’s guests are invited by email.
- Team roles are fixed. Owner, admin and member.
Security
Section titled “Security”The open items of the security model are listed in Known gaps.
Operations
Section titled “Operations”- Nothing pages the operator. Metrics, logs and traces are kept inside the installation. Alert rules fire in its Grafana, and no contact point tells anyone. A workspace’s owner is emailed when it waits for them.
- An update is one way. A release older than the one that last started the database refuses to start on it. Going back past a schema change is a point-in-time restore of the database.
Installations run Spinbox v20261027.01; the reference is generated from spin v20261114.01 (51f7e0dea). This page as Markdown, for a model or a terminal.

