> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stateset.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Sandbox Architecture Overview

> High-level design of the StateSet Sandbox platform.

# Sandbox Architecture Overview

StateSet Sandbox runs in Kubernetes with a controller that manages sandbox lifecycles, a warm pod pool for fast startup, and isolated execution runtimes.

## Core Components

* **Controller**: Stateless API service that provisions and manages sandboxes
* **Warm Pod Pool**: Pre-initialized pods to reduce startup latency
* **State Stores**: Redis for coordination and Postgres/CloudSQL for persistence
* **Isolated Runtimes**: gVisor, Kata, or container isolation by policy

## Request Flow

1. Client calls the Sandbox API.
2. Controller claims a warm pod (or creates one).
3. Pod is configured for the org and timeout.
4. Exec/WebSocket streams connect to the sandbox.

## Performance Model

Warm pool provisioning keeps sandbox creation typically under 100ms for common profiles.

## Related Documentation

* [Sandbox Architecture (Full)](/stateset-sandbox/ARCHITECTURE)
* [Operations Guide](/stateset-sandbox/OPERATIONS)