mrkeyoor.com_
Fri 25 Sept 19:58 UTC
Dev Toolsevaluationupdated 27 Aug 2026

microsandbox review

Microsandbox runs untrusted code in local microVMs controlled through a CLI or language SDK. It gives agent builders, plugin hosts, CI tools, and code runners stronger process separation than an ordinary container without requiring a permanent sandbox server.

+120stars / 7d
Verdict

Our Microsandbox build failed after 347 seconds and its tests failed after 110 seconds because the linker could not find cap-ng. The product shape is attractive for local agent code execution, especially with SDKs across 5 languages and no daemon to operate. Use the packaged beta for evaluation, but require a security review and host-specific tests before treating it as the boundary around hostile code.

We ran it

Lab card: what happened when we ran microsandboxScreenshot of microsandbox (docs.microsandbox.dev)
Install✓ · 47s776 packages
Build✗ · 347s
Tests✗ · 110sran, no count parsed
Repo1769 files~323,474 lines of source · 120 MB · 10 CI workflows

Answers from our run

Does microsandbox build from source?

Dependencies installed in 47 seconds (776 packages), and the build failed. We cloned commit bb03217 into a clean Debian container with 3 CPUs and no project-specific setup.

Do microsandbox's tests pass?

The test command failed in our container, and its output did not report a pass or fail count.

Who should not use microsandbox?

Hosts without hardware virtualization: Linux needs KVM, Windows needs WHP, and the documented macOS path requires Apple Silicon.

What are the alternatives to microsandbox?

Firecracker, Kata Containers, gVisor. Our Microsandbox build failed after 347 seconds and its tests failed after 110 seconds because the linker could not find cap-ng.

Setup2/547-second install; build and tests need an unlisted system library
Docs4/5CLI, SDK, host requirements, and examples are easy to find
Community4/57,945 stars with releases and issue activity this week
Maturity2/5v0.6.15 is active, but the project explicitly remains beta

Discussed on

  1. hnMicrosandbox – local-first programmable micro VMs3 points

Who it’s for

Agent developers who need local execution boundaries around generated or user-supplied code.
Application teams that want to create microVMs directly from TypeScript, Rust, Python, Go, or Ruby.
Developers already using OCI images who want familiar image, command, volume, and network controls.
Cross-platform teams prepared to meet KVM, WHP, or Apple Silicon requirements and absorb beta changes.

Who it’s NOT for

Hosts without hardware virtualization: Linux needs KVM, Windows needs WHP, and the documented macOS path requires Apple Silicon.
Production teams requiring a stable interface: the README labels Microsandbox beta software and warns of breaking changes and missing features.
Builders who assume a large root disk gives /tmp the same capacity: open issue 1377 documents an automatic 512 MiB ceiling for /tmp in common OCI guests.
Security teams unwilling to test secret modification paths: open issue 1422 reports that adding the first secret later can leave TLS interception disabled in v0.6.10.

Setup reality

Our sandbox installed 776 Rust packages in 47 seconds. The build failed with exit 101 after 347 seconds, and tests failed with exit 101 after 110 seconds; both linker logs said the system library cap-ng could not be found.

Packaged use can start with npx microsandbox run debian or an installer, while SDKs are published for TypeScript, Rust, Python, Go, and Ruby. The first sandbox creation downloads its OCI image, so it needs registry access and cache space.

The host must provide Apple Silicon virtualization, Linux KVM, or Windows Hypervisor Platform. Network allowlists, volumes, disk size, CPU, memory, and secret host bindings need deliberate configuration. The project is beta, and a separate MCP server is required for agent tool calls.

Local microVMs target code you do not trust

Microsandbox creates a small virtual machine as a child process of the calling application. The README positions it for AI agents, user code, plugins, CI jobs, development environments, scrapers, and automation. There is no required control-plane server or long-running daemon. A TypeScript, Rust, Python, Go, or Ruby program can choose an OCI image, CPU count, memory limit, network policy, mounts, and command, then stop the sandbox when the work is finished.

The CLI mirrors common container habits: run a command, create a named sandbox, execute inside it, stop or start it, manage images, inspect configuration, and watch CPU, memory, or network metrics. OCI compatibility means familiar images can come from Docker Hub, GHCR, or another registry. Detached mode supports longer sessions, and named volumes cover state that should outlive one process. This is a usable application interface over virtualization, rather than a raw virtual-machine monitor.

Five SDKs avoid a permanent sandbox service

Published installation paths cover npm, Cargo, uv, Go modules, and Ruby. The same builder pattern appears across languages, while the first create() call downloads an uncached image. That makes local development simple once host virtualization works. It also means the first job depends on registry access, image size, cache capacity, and any policy around what registries developers may contact.

Network settings can limit allowed hosts and ports. The Ruby example also binds an environment secret to an approved host, with the design keeping the actual value on the host and substituting it into permitted outbound traffic. That is a useful model for an agent that needs one API without receiving the credential directly. It deserves adversarial testing because the entire reason to choose a microVM is that code inside it is untrusted.

What happened when we ran it

Our Rust sandbox installed 776 packages in 47 seconds at commit bb03217. The checkout contained 1,769 files, about 323,474 source lines, and occupied 120 MB. We found 10 CI workflow files, no Dockerfile, and no top-level tests directory. Installation completed, but source compilation did not reach a usable msb binary.

The build ran for 347 seconds before Cargo exited with code 101. rust-lld said it could not find the system library cap-ng, and the linker then failed while compiling microsandbox-cli. Tests failed after 110 seconds for the same missing cap-ng library while compiling the microsandbox-node library test. The log establishes one missing native dependency in our fresh Debian container. It does not show whether any test assertion would have failed after linking.

Hardware support is broad but conditional

Linux requires KVM, Windows requires Windows Hypervisor Platform, and the documented macOS route requires Apple Silicon. Those conditions exclude ordinary locked-down containers, many cloud guests without nested virtualization, and Intel Macs. The project calls itself cross-platform because it supports 3 host families, but each family has a different virtualization backend and failure surface. A successful laptop trial does not certify a CI runner or production host.

The README reports average boot time under 100 milliseconds from project benchmarks, but our lab did not measure VM startup. We also did not run hostile code, inspect device exposure, test network escapes, or validate secret isolation because the build stopped at linking. Teams choosing it for security should review the threat model, guest kernel, mount rules, egress enforcement, update process, and behavior when the host application crashes.

/tmp and late-added secrets have concrete beta gaps

Open issue 1377 documents an automatic RAM-backed /tmp for OCI sandboxes, sized at one quarter of guest memory and capped at 512 MiB. In the report, a 20 GiB root disk still leaves /tmp at 512 MiB. Build tools frequently stage files there, so a large configured root overlay may not prevent ENOSPC. A proposed pull request adds an opt-out, but the issue remained open when researched.

Issue 1422 covers a narrower security path in v0.6.10. Creating a sandbox with a source-backed secret enabled TLS interception, while adding the first secret later through modify() persisted the binding without enabling interception. The placeholder then reached the upstream service unchanged. The latest release was v0.6.15, yet the issue was still open, so confirm the behavior in the exact SDK and runtime pair you plan to ship.

August releases show speed and churn

GitHub recorded 7,945 stars, 75 combined issues and pull requests, and a push on August 27, 2026. Version 0.6.15 was released on August 24 with Windows DNS work, read-only mount handling, directory ownership fallback, and packaging updates. Current pull requests cover network observers, proxy support, mount deny lists, lifecycle APIs, and runtime bootstrap. This is active engineering around areas that affect isolation and operations.

The same activity also supports the beta warning. Microsandbox is moving across CLI behavior, SDK lifecycle, networking, filesystems, and platform backends at once. It is worth prototyping when an embedded local VM is a better fit than a Kubernetes sandbox service. Pin CLI and SDK versions together, test the host you will deploy, and keep a path to disable execution if the isolation assumptions fail review.

Alternatives

ProjectWhat it isPick it when
Firecracker gh↗A Linux microVM monitor built for secure multi-tenant container and function workloads.pick this instead when Linux infrastructure, a lower-level VM boundary, and production control matter more than desktop SDK convenience.
Kata ContainersA container runtime that places workloads inside lightweight virtual machines.pick this instead when Kubernetes and OCI runtime integration are the center of the deployment.
gVisor gh↗A user-space application kernel that adds an isolation layer around containers.pick this instead when Linux container compatibility matters more than a hardware-backed microVM per sandbox.

What people are saying

  1. [github-trending] superradcompany/microsandbox

Sources

  1. Microsandbox README
  2. Microsandbox v0.6.15 release
  3. OCI tmpfs issue 1377
  4. Secret modification issue 1422

More dev tools reviews

Claude-Code-Usage-Monitor · pyxel · dust · kubernetes-the-hard-way · wifit3 · badnotes · the whole board →