Security model
Spinbox runs code its operators do not fully trust, on machines in their own account. Its security model starts from that: a workspace’s tenant is root inside it, and may be hostile. Everything else is built to keep root in a workspace from reaching anything outside it. The pages below describe how, mechanism by mechanism; none of them is a guarantee.
What it protects
Section titled “What it protects”| Asset | From |
|---|---|
| Other workspaces, and the runner | Code inside a workspace, including root and the kernel |
| The installation’s network and the cloud account | A workspace’s traffic |
| Workspaces’ disks and memory | Anyone who reads the bucket, or a runner’s disk |
| The installation’s secrets | Anyone who reads the database alone |
| Each user’s workspaces, snapshots and ports | Other users of the installation |
| What a machine runs | Anyone who changes an image, a package or a release after it was built |
The layers
Section titled “The layers”- Isolation. Every workspace is a virtual machine with its own kernel. Its QEMU runs as its own user, in an empty network namespace and a bounded cgroup, and reaches nothing on the host but what it is handed.
- Network. A workspace reaches nothing until a policy allows it, a DNS question for a name the policy does not name included. Its traffic to the runner’s own networks and the cloud’s metadata service is dropped before any policy is read, and nothing dials into it: what comes in is a session through the proxy, opened from the runner’s side. See Network and egress and Network on AWS.
- Data and encryption. Every layer of every disk is encrypted with its volume’s key before it leaves the runner. Keys are wrapped under a key the database does not hold. Memory snapshots have keys of their own, destroyed with them.
- Identity and access. Every request is authorized against the resource it names, at the time it is made. “Not yours” is answered as “not found”.
- Supply chain. Every release is signed and checked before it is unpacked. Every machine boots a read-only root the kernel verifies block by block.
Rules with gates
Section titled “Rules with gates”Spinbox keeps its security rules in a table in its repository, docs/security/README.md. Each rule
names the code that keeps it and the test that fails the build when it is broken, and a rule no
test keeps says so. The site prints that table, Rules and their gates,
and the README’s open items, Known gaps, from spin itself.
Those rules hold against a workspace, a stolen session or a copied credential. Against the control plane itself running someone else’s code they mostly do not: it holds every key and decides who logs in, and the README says so in What this does not protect. No way of doing that is known, and no outside test has looked for one yet.
To report a problem, see Reporting a vulnerability.
Installations run Spinbox v20261027.01; the reference is generated from spin v20261114.01 (51f7e0dea). This page as Markdown, for a model or a terminal.

