Try describing what you need:

OpenSandbox logo

OpenSandbox

★ 17.3k
Apache License 2.0Open Source — No Paywall2 Containers — 2 containers — light hosting footprintDocker · K8s · PackageNo external DB10 documented maintainers

About

OpenSandbox is a sandbox orchestration platform for AI applications that need isolated execution environments. It is aimed at developers building coding agents, browser automation, desktop...

Community Ratings

No ratings yet

Features

  • Fast sandbox runtime
  • Pause/resume with preserved state
  • Command execution
  • File management
  • Browser and desktop automation
  • Network access control
  • Credential vault
  • SDKs and CLI
  • MCP server
  • Sandbox lifecycle API

Details

Last Updated
Nov 14, 2026
Created
Dec 17, 2025
Install Methods
dockerkubernetespackage-manager
Requirements
DockerPython 3.10+
Default Port
8090From the project's Compose file
API
REST
Privacy & Independence
Cloud: Optional
Deployment

Deployment: Docker Compose ✓2 Containers — light hosting footprintRuns as 2 containers

Run OpenSandbox yourself

Pick how much you want to manage.

1 more way to host

Some links earn us a commission. netcup pays us one and is our preferred VPS host.

Is this your project? Sponsor a listing

Run OpenSandbox with Docker Compose

Compose file from the OpenSandbox project repository.

2 services · 1 unclassified (python)

no resource limits declared

needs persistent storage (1 volume)

server/docker-compose.example.yaml · @ f5fe25a · scanned Nov 3, 2026

configs:
  opensandbox-config:
    content: |
      [server]
      host = "0.0.0.0"
      port = 8090

      [proxy]
      # The lifecycle server is attached to opensandbox-net, while sandboxes
      # created through the mounted Docker socket use Docker's bridge network.
      # Route through host-published ports instead of unreachable sandbox IPs.
      resolve_internal = false

      [log]
      level = "INFO"

      [runtime]
      type = "docker"
      # execd_image = "opensandbox/execd:v1.1.0"
      execd_image = "sandbox-registry.cn-zhangjiakou.cr.aliyuncs.com/opensandbox/execd:v1.1.0"

      [egress]
      image = "opensandbox/egress:v1.1.7"
      # image = "sandbox-registry.cn-zhangjiakou.cr.aliyuncs.com/opensandbox/egress:v1.1.7"
      readiness_timeout_seconds = 30.0

      [docker]
      network_mode = "bridge"
      # Required when the server runs in a container: host-mapped endpoints and
      # proxy targets must resolve back to the Docker host.
      host_ip = "host.docker.internal"
      port_range_min = 40000
      port_range_max = 60000
      # Optional: publish sandbox ports on ONE host address instead of every interface, e.g. the
      # Docker bridge gateway (an IP, not a name) — then only containers on the host reach execd.
      # publish_host = "172.17.0.1"
      drop_capabilities = ["AUDIT_WRITE", "MKNOD", "NET_ADMIN", "NET_RAW", "SYS_ADMIN", "SYS_MODULE", "SYS_PTRACE", "SYS_TIME", "SYS_TTY_CONFIG"]
      no_new_privileges = true
      # TODO: For production environments, it is recommended to set this to '4096' or higher to avoid
      # "can't start new thread" errors when multiple sandboxes are running concurrently.
      # See: https://github.com/opensandbox-group/OpenSandbox/issues/447
      pids_limit = 4096

      [ingress]
      mode = "direct"

version: '3.8'

services:
  opensandbox-server:
    # Includes configurable proxy resolution for this Compose/bridge topology.
    image: opensandbox/server:release-1.1.0
    container_name: opensandbox-server
    networks:
      - opensandbox-net
    extra_hosts:
      - "host.docker.internal:host-gateway"
    ports:
      - "8090:8090"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
    configs:
      - source: opensandbox-config
        target: /etc/opensandbox/config.toml
    environment:
      - SANDBOX_CONFIG_PATH=/etc/opensandbox/config.toml

  sdk-client:
    image: python:3.11-slim
    container_name: sdk-client
    networks:
      - opensandbox-net
    extra_hosts:
      - "host.docker.internal:host-gateway"
    command: >
      sh -c "pip install opensandbox && tail -f /dev/null"
    environment:
      - OPENSANDBOX_SERVER_URL=http://opensandbox-server:8090

networks:
  opensandbox-net:
    driver: bridge

This file may be out of date. Check the OpenSandbox documentation for current setup steps.

Track your self-hosted stack

Bookmark software to try, rate tools you've used, and keep your collection in one place.

Metadata extracted from README on Oct 16, 2026

Alternatives to OpenSandbox

agentos logo

agentos

4.9k
agentOS provides tiny, fast Linux-compatible sandboxes powered by WebAssembly for running isolated agents and workloads.
AI AgentsArtificial IntelligenceAI Tooling
Single ContainerFreemium
Details
daytona logo

daytona

71.3k
Daytona is a secure infrastructure runtime for running AI-generated code and agent workflows in isolated sandboxes.
Artificial IntelligenceAI AgentsAI Tooling+2
Details
runtm logo

runtm

304
Runtm is an open-source platform for spinning up isolated sandboxes where coding agents can build, test, and deploy software.
Self Hosting SolutionsAI AgentsAI Tooling+1
4 Containers
Details
E2B logo

E2B

1.8k
An open-source runtime that powers E2B Cloud, providing isolated Firecracker microVM sandboxes that can be paused, resumed, and forked for running untrusted agent code.
AI AgentsAI ToolingOpen Core+1
21 ContainersOpen Core
Details
open-terminal logo

open-terminal

3.6k
Open Terminal is a self-hosted terminal service for AI agents and automation tools that provides command execution, file management, and code running through a REST API.
Self Hosting SolutionsAutomation ToolsAI Agents+2
Details

Related Software

agent-vault logo

agent-vault

2.5k
An open-source HTTP credential proxy and vault that brokers API credentials for AI agents without exposing the secrets directly to the agents.
Secret ManagementProxy ServersSelf Hosting Solutions+2
2 Containers
Details
omnara logo

omnara

3.4k
Omnara is an open-source managed agent platform for running AI agents on any model and any machine, with built-in tools, secrets, permissions, and streaming.
AI AgentsAI ToolingPlatform as a Service+3
10 ContainersFully FOSS
Details
centaur logo

centaur

1.4k
Centaur is a self-hosted platform for teams to run shared AI agents in Slack or through an API, with isolated sandboxes and durable workflows.
Artificial IntelligenceAI AgentsAutomation Tools+2
Details
Sim Studio logo

Sim Studio

30.1k
An open-source platform for building AI agents and orchestrating agentic workflows with integrations, LLMs, and vector databases.
Automation ToolsArtificial IntelligenceAI Tooling+4
Details
onecli logo

onecli

3.6k
OneCLI is an open-source gateway that sits between AI agents and external services to inject and manage API credentials securely.
AI AgentsSecret ManagementModel Context Protocol+1
2 Containers
Details
OpenHands logo

OpenHands

93.4k
An AI-driven development platform with a software agent SDK, CLI, local GUI, and hosted cloud offering.
Artificial IntelligenceAI Coding AssistantAI Agents+2
Single ContainerOpen Core
Details
Trigger.dev logo

Trigger.dev

16.8k
An open-source platform for building and deploying AI workflows and agents in TypeScript.
Task RunnersArtificial IntelligenceAutomation Tools+4
Details
Pi logo

Pi

121.9k
Pi Agent Harness is a mono-repo for a self-extensible coding agent, including an interactive coding agent CLI, agent runtime, and a unified multi-provider LLM API.
AI HarnessAI AgentsAI Coding Assistant+1
Details
ouijit logo

ouijit

178
Ouijit is a customizable task and terminal session manager for agentic development workflows, with lifecycle hooks, scripts, worktree management, and VM sandboxing.
Task RunnersAI Coding AssistantAI Agents
Details
flue logo

flue

8.7k
Flue is a TypeScript framework for building autonomous agents with a programmable harness, tools, skills, sandboxes, and deployment options.
AI AgentsAutomation ToolsAI Tooling+1
Details
orca logo

orca

124.4k
Orca is an AI orchestrator for running multiple coding agents side-by-side in isolated worktrees, with a desktop app, mobile companion, and CLI automation.
AI AgentsAI Coding AssistantAI Tooling+1
Details
Flowise logo

Flowise

55.6k
Flowise is a visual tool for building AI agents.
Self Hosting SolutionsAI AgentsAI RAG Systems+3
Single Container
Details