Agent Sandboxesagentsandboxes.org
Sandbox profile · Local / OS-level

Gondolin

Answer in brief

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.

By the Agent Sandboxes editors · Updated

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

AttributeDetails
IsolationLocal 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
DeploymentLocal / OS-level
Open sourceYes (Apache-2.0)
SDKs and interfacesJavaScript/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 lengthNot documented
PersistenceEach 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
GPUNot documented
NetworkingNo 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
PricingFree (Apache-2.0)
Free tierFree
ComplianceNot documented
RegionsNot documented
Company headquartersNot 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

SandboxCompany HQIsolationOpen sourceSelf-host / BYOCCold start (vendor)Max sessionSnapshots / pauseGPUSDKs
GondolinNot documentedlibkrun / QEMU micro-VMYesNo / No<1 s boot (claim)Not documentedYes / NoNot documentedJavaScript/TypeScript, CLI
MatchlockNot documentedFirecracker / Apple VZ microVMYesYes / Not documented<1 s (claim)Not documentedNot documented / Not documentedNot documentedGo, Python, JavaScript/TypeScript, CLI
MicrosandboxNot documentedMicroVM (libkrun)YesYes / Yes<100 msNot documentedYes / Not documentedNot documentedTypeScript, Python, Rust, Go, Ruby, CLI, MCP server
Celesto (SmolVM)Not documentedFirecracker / QEMU microVMYesYes / Not documented~500 ms (claim)Not documentedYes / YesNot documentedPython, JavaScript/TypeScript, CLI, MCP server
BoxLiteNot documentedmicroVM + jailerYesYes / Not documented~1 s (claim)Not documentedNot documented / Not documentedNot documentedPython, JavaScript/TypeScript, Go, Rust, C, CLI, REST API
agents-sandboxGermanymicrosandbox microVMYesNo / NoNot documentedNot documentedNot documented / Not documentedNot documentedCLI
libkrunNot documentedIn-process microVMYesYes / NoNot documentedNot documentedNot documented / Not documentedYesRust, C

Head-to-head: Gondolin vs Matchlock

See all Gondolin alternatives →

Frequently asked questions

What is 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.
How does Gondolin isolate code?
Gondolin documents its isolation as: 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.
Is Gondolin open source?
Yes (Apache-2.0).
How much does Gondolin cost?
Free (Apache-2.0) Check the official pricing page for current rates.
Does Gondolin support snapshots or pause and resume?
Snapshots: yes. Pause and resume: none documented. 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.
What are the alternatives to Gondolin?
Common alternatives include Matchlock, Microsandbox, Celesto (SmolVM), BoxLite, agents-sandbox, libkrun. See Gondolin alternatives for a full comparison.

Sources

  1. earendil-works.github.io/gondolin/
  2. earendil-works.github.io/gondolin/quickstart/
  3. earendil-works.github.io/gondolin/workloads/
  4. earendil-works.github.io/gondolin/snapshots/
  5. earendil-works.github.io/gondolin/network-access/
  6. earendil-works.github.io/gondolin/limitations/
  7. github.com/earendil-works/gondolin
  8. 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/