Files
OpenHands/openhands/app_server/sandbox
2026-01-03 05:41:31 +00:00
..
2025-10-14 02:16:44 +00:00
2025-11-20 10:52:13 +00:00
2025-10-14 02:16:44 +00:00
2025-10-14 02:16:44 +00:00

Sandbox Management

Manages sandbox environments for secure agent execution within OpenHands.

Overview

Since agents can do things that may harm your system, they are typically run inside a sandbox (like a Docker container). This module provides services for creating, managing, and monitoring these sandbox environments.

Key Components

  • SandboxService: Abstract service for sandbox lifecycle management
  • DockerSandboxService: Docker-based sandbox implementation
  • SandboxSpecService: Manages sandbox specifications and templates
  • SandboxRouter: FastAPI router for sandbox endpoints

Features

  • Secure containerized execution environments
  • Sandbox lifecycle management (create, start, stop, destroy)
  • Multiple sandbox backend support (Docker, Remote, Local)
  • User-scoped sandbox access control