Overview
What Opensbx is, why it exists, and how it works.
Opensbx
Opensbx is a self-hosted, API-first sandbox runtime for executing untrusted or AI-generated code in isolated Docker environments.
It is built for teams that want infrastructure control, predictable costs, and clear runtime boundaries.
Core Capabilities
- Create disposable sandboxes from Docker images.
- Execute commands and stream logs.
- Read, write, list, and delete files inside sandboxes.
- Expose sandbox services through generated subdomain URLs.
- Apply resource and timeout limits.
- Stop and delete sandboxes cleanly.
Why Teams Use Opensbx
- Self-hosted control: run on your own servers and network.
- Lightweight architecture: no Kubernetes control plane required.
- API-first workflows: easy integration with apps, tools, and agents.
- AI-ready runtime: designed for generated script and code execution.
- MCP support: includes a
/v1/mcpendpoint. - Low lock-in: you control images and operations.
Typical Use Cases
- AI coding agents and tool execution.
- Code execution products.
- User-submitted script runners.
- Disposable CI or test workloads.
- Internal dev and prototyping environments.
Conceptual Flow
- Use an existing image like
node:22orpython:3.12. - Create a sandbox with optional ports, env vars, timeout, and resource limits.
- Run commands and read logs via the API.
- Manage files and directories via the API.
- Access exposed services through generated subdomain URLs.
- Stop or delete the sandbox, or let timeout auto-stop it.
Next Steps
Getting Started
Quickstart flow and first sandbox execution.
Runtime: Installation
Prerequisites, Docker setup, and optional gVisor hardening.
Runtime: Configuration
Environment variables, flags, defaults, and auth model.
Networking: Reverse Proxy and Domains
Local and production subdomain routing.
Networking: MCP
MCP endpoint behavior and initialization checks.
Deployment: Cloudflare Tunnel
End-to-end production setup with wildcard routing.
Reference: API Overview
Endpoint groups, auth model, and schema summary.
Reference: Swagger and OpenAPI
Generate and update OpenAPI docs.
Operations: Testing
Unit and integration test workflows.
Operations: Releases
Tag-based release flow and distribution.