Runtime Selection
The sandbox offers three isolation runtimes. They trade the same three things against each other: how strong the boundary is, how fast a sandbox starts, and how much of Linux the workload gets.If you donβt choose, you get gVisor. It is the right default for agentic workloads β real Linux
compatibility with a syscall boundary, at low startup cost. Read on only if your workload is
unusually short, unusually hostile, or unusually compliance-bound.
At a glance
Choosing
WebAssembly
Code runs in a lightweight stack-based virtual machine rather than a container β there is no OS to boot, which is where the millisecond startup comes from. Use it for ultra-short tasks (under a second), pure logic and compute β validating a JSON schema, evaluating an expression, a numeric transform β and for scale where startup time dominates total execution time. The cost: WASI only. No full Linux syscall surface, no arbitrary processes, nogit or npm.
Your workload must be compiled to .wasm, or run inside a Wasm-compiled interpreter (Python or JS
in Wasm), which is a real build-pipeline commitment.
gVisor
A user-space kernel β the βSentryβ β intercepts syscalls, so the container never talks directly to the host kernel. Startup is fast and memory overhead is low, whilebash, the filesystem, and
compilers all behave normally.
Use it for standard CLI coding agents, workloads that need ordinary Linux tooling (git,
curl, grep, npm), MCP-connected toolchains, and any βdo work β write files β exitβ flow.
The cost: some syscalls are emulated or restricted. Workloads that probe unusual kernel
interfaces can behave differently than on bare Linux.
Kata Containers
Each container runs inside its own lightweight VM using hardware virtualization. No shared kernel β the strongest boundary available. Use it for high-risk untrusted customer binaries, workloads that need root and might attempt to escape a container, and compliance regimes that specifically require VM-level isolation. The cost: higher startup latency, more memory and CPU per sandbox, lower density. You are trading velocity and money for a boundary you may not need.The tiered model
Rather than standardising on one runtime, route by workload class:Related
- Sandboxes β what the sandbox is for
- Architecture β how the runtimes are wired in
- Security Guide β the full threat model
- Production Guide