Gondolin
Apache-2.0 local Linux micro-VMs for agent-generated code, driven from a TypeScript SDK or CLI, with network egress, secrets and file mounts controlled by host-side JavaScript policy. A local micro-VM sandbox whose distinctive feature is host-side, JavaScript-programmable control of network, secrets and files; the docs call it an early project.
Overview
Gondolin, built by Earendil, runs code from AI agents inside "lightweight micro-VMs" on a Mac or Linux machine: libkrun on Apple silicon and on Linux x86_64 with KVM, and QEMU on other hosts. You create a VM from the TypeScript SDK (VM.create(), vm.exec()) or open a shell with npx @earendil-works/gondolin bash. The network stack and virtual filesystem run on the host in a small daemon and are programmable from JavaScript: HTTP(S) allowlists and request/response hooks, placeholder-based secret injection so the guest never sees the real token, and custom VFS mounts. An ingress gateway exposes guest HTTP services, SSH is supported, and the daemon can run on a remote machine while policy and credentials stay local.
The docs target a run-persist-discard lifecycle per agent turn or task. Root disks are thrown away by default; disk checkpoints let you prepare an environment once and resume many VMs from it, but the limitations page states that Gondolin "does not provide full VM save/restore" of RAM and process state. Guest images are Alpine-based (~200 MB+, downloaded on first use), and the image builder supports only Alpine. Requires Node.js 22.19 or newer. The docs call it "an early project"; the latest tagged release on GitHub is v0.14.0 (October 2026).
Notable
- Docs: "this is an early project"; latest GitHub release v0.14.0 (22 October 2026)
- Secrets are injected by the host only for allowed destinations; the guest sees a placeholder
- Disk-only checkpoints (.qcow2) can be resumed many times in parallel; no RAM or process save/restore
Gondolin specifications
| Attribute | Details |
|---|---|
| Isolation | Local Linux micro-VM per sandbox: libkrun where available (macOS on Apple silicon, Linux x86_64 with read/write /dev/kvm) and QEMU otherwise (Intel Macs, Linux arm64, Linux x86_64 without KVM via TCG); networking and the virtual filesystem run in a host daemon (gondolind) outside the guest |
| Deployment | Local / OS-level |
| Open source | Yes (Apache-2.0) |
| SDKs and interfaces | JavaScript/TypeScript, CLI |
| Cold start (vendor claim) | Docs: VMs "boot in under a second" on a Mac or Linux machine (vendor claim); no measurement methodology given |
| Max session length | Not documented |
| Persistence | Each VM starts from a clean copy of its image and the root disk is discarded on close by default (root disk modes readonly, memory or cow); disk-only checkpoints capture the writable root disk as a .qcow2 file that many VMs can resume from in parallel; tmpfs paths and VFS mounts are not in checkpoints, and durable data is meant to go to a host-backed mount such as /workspace |
| GPU | Not documented |
| Networking | No NAT: the host daemon terminates guest traffic. HTTP/1.x and HTTPS are parsed and performed by the host (TLS intercepted with a local CA the guest trusts), with any public host allowed by default and loopback, private, link-local and metadata ranges blocked; other TCP and non-DNS UDP are dropped. allowedHosts / --allow-host restrict egress, and JavaScript hooks or daemon-side policies can filter and rewrite requests; secrets reach the guest only as placeholders that the host replaces for allowed hosts. HTTP/2, HTTP/3 and QUIC are not supported |
| Pricing | Free (Apache-2.0) |
| Free tier | Free |
| Compliance | Not documented |
| Regions | Not documented |
| Company headquarters | Not documented |
Facts from Gondolin’s public documentation, verified November 18, 2026. Performance numbers are vendor claims.
Strengths and trade-offs
Strengths
- You want a microVM boundary around agent code on your own Mac or Linux machine without a cloud service
- You need egress allowlists and request hooks written in JavaScript rather than fixed profiles
- You want credentials usable by the guest without ever placing them inside it
- You want to prepare a base environment once and start many disposable VMs from a checkpoint
Trade-offs
- Docs describe it as an early project
- No full VM save/restore; checkpoints capture the root disk only
- Only Alpine guest images; HTTP/2, HTTP/3, QUIC and generic UDP are not supported through the network mediation
- TypeScript SDK only; requires Node.js 22.19+ (a static CLI is also available)
Good fit for: Running agent-generated code in disposable local micro-VMs where egress, credentials and file access must stay under programmable host-side policy.
How Gondolin compares
| Sandbox | Company HQ | Isolation | Open source | Self-host / BYOC | Cold start (vendor) | Max session | Snapshots / pause | GPU | SDKs |
|---|---|---|---|---|---|---|---|---|---|
| Gondolin | Not documented | libkrun / QEMU micro-VM | Yes | No / No | <1 s boot (claim) | Not documented | Yes / No | Not documented | JavaScript/TypeScript, CLI |
| Matchlock | Not documented | Firecracker / Apple VZ microVM | Yes | Yes / Not documented | <1 s (claim) | Not documented | Not documented / Not documented | Not documented | Go, Python, JavaScript/TypeScript, CLI |
| Microsandbox | Not documented | MicroVM (libkrun) | Yes | Yes / Yes | <100 ms | Not documented | Yes / Not documented | Not documented | TypeScript, Python, Rust, Go, Ruby, CLI, MCP server |
| Celesto (SmolVM) | Not documented | Firecracker / QEMU microVM | Yes | Yes / Not documented | ~500 ms (claim) | Not documented | Yes / Yes | Not documented | Python, JavaScript/TypeScript, CLI, MCP server |
| BoxLite | Not documented | microVM + jailer | Yes | Yes / Not documented | ~1 s (claim) | Not documented | Not documented / Not documented | Not documented | Python, JavaScript/TypeScript, Go, Rust, C, CLI, REST API |
| agents-sandbox | Germany | microsandbox microVM | Yes | No / No | Not documented | Not documented | Not documented / Not documented | Not documented | CLI |
| libkrun | Not documented | In-process microVM | Yes | Yes / No | Not documented | Not documented | Not documented / Not documented | Yes | Rust, C |
Head-to-head: Gondolin vs Matchlock
Frequently asked questions
What is Gondolin?
How does Gondolin isolate code?
Is Gondolin open source?
How much does Gondolin cost?
Does Gondolin support snapshots or pause and resume?
What are the alternatives to Gondolin?
Sources
- earendil-works.github.io/gondolin/
- earendil-works.github.io/gondolin/quickstart/
- earendil-works.github.io/gondolin/workloads/
- earendil-works.github.io/gondolin/snapshots/
- earendil-works.github.io/gondolin/network-access/
- earendil-works.github.io/gondolin/limitations/
- github.com/earendil-works/gondolin
- earendil.com
Check before you rely on it. Products change quickly, and this page reflects public documentation as of November 18, 2026. Confirm anything that matters in the provider’s own documentation.
Cite this page
Agent Sandboxes. (2026). Gondolin. agentsandboxes.org. Last reviewed November 18, 2026. https://agentsandboxes.org/sandboxes/gondolin/