Welcome to VoidRun
VoidRun is a modern sandbox environment that provisions highly secure, isolated MicroVMs for AI agents and developers. Execute code safely with production-grade security and lightning-fast performance.π Quick Start
Get up and running with VoidRun in under 5 minutes.
π Core Concepts
Understand sandboxes, lifecycle, and execution models.
What is VoidRun?
VoidRun provides isolated MicroVM environments designed for AI workloads and developer tooling. Whether youβre building AI agents, code interpreters, or CI/CD pipelines, VoidRun offers the security and flexibility you need.Key Features
β‘ Performance
Sandboxes run without a hard timeout. Idle sandboxes auto-sleep and wake on the next request in a fraction of a second.
π³ Flexible Environments
Custom Docker images supported. Run Docker and K3s natively inside sandboxes.
π Security
Granular internet access control with allowlists and blocklists. Native Tailscale VPN connectivity.
π» Code Execution
Full code interpreter capabilities. Install Ubuntu, Python, and TypeScript packages dynamically.
π Direct Access
Interact with sandboxes via VNC and SSH for debugging and development.
π Simple Auth
API key authentication via the
X-API-Key header; SDKs use VR_API_KEY (see SDKs and API). Self-hosted: override the API base URL with VR_API_URL or constructor options.How It Works
VoidRun architecture is built on MicroVMs for maximum isolation and security:1
Create a Sandbox
Provision an isolated MicroVM with your preferred configuration and base image.
2
Execute Code
Run commands, upload files, and execute code in multiple languages securely.
3
Manage Lifecycle
Sandboxes run without a hard timeout, auto-sleep when idle, and wake on the next request.
4
Clean Up
Delete sandboxes when finished, or let them stay snapshotted for later use.
Use Cases
AI Code Execution
Build AI agents that can safely execute generated code in isolated environments:Development Environments
Spin up ephemeral development environments with custom tooling:Who is VoidRun For?
Next Steps
Ready to start building? Check out the Quickstart Guide to create your first sandbox.
Examples
Step-by-step sandbox patterns (interpreter, CI, ETL, PTY, watch, cleanup), each on its own page.
SDKs & API
TypeScript and Python packages, auth headers, env vars, and REST overview.
VoidRun MCP
Cursor and other MCP clients: install
mcp.json, auth, tools, resources, and agent-oriented response shapes.OpenAPI & HTTP
How the REST API relates to the SDKs and error payloads.
Resources
π Dashboard
Manage your sandboxes at dash.void-run.com
π GitHub
Star us on GitHub
π¬ Community
Issues, releases, and updates on GitHub.

