# Agent Substrate > Agent Substrate is an open source, zero-trust runtime for running millions of stateful sandboxed agents on Kubernetes with sub-500ms suspend and resume. Agent Substrate maps stateful **Actors** (addressed as `/` and created from an `ActorTemplate`) onto smaller pools of pre-warmed **Workers** (Kubernetes Pods in a `WorkerPool`). Idle actors checkpoint their memory and filesystem state to object storage (GCS or S3) and release compute. When a request arrives with the `ate-target-actor: /` header, `atenet-router` parks the request while `ate-api-server` assigns a ready worker, `atelet` streams the snapshot on the node, and `ateworker` restores the sandbox off the Kubernetes control-plane path. Every actor runs inside a Cloud Hypervisor microVM or gVisor (`runsc`) sandbox. Plain Linux containers are unsupported. Actors hold zero ambient credentials inside the sandbox and start with default-deny networking. Outbound traffic traverses `atunnel` (authenticated with a short-lived per-actor SPIFFE X.509 certificate) to `atenet-egress`, which enforces `EgressPolicy` host allowlists and injects external credentials or actor JWTs out of band. Substrate splits its APIs between cluster infrastructure and tenant workloads. Infrastructure resources (`WorkerPool`, `SandboxConfig`, `CSIDriverConfig` under `ate.dev/v1`) are Kubernetes CRDs reconciled by `atecontroller` and managed with `kubectl`. Workload and access resources (`Atespace`, `ActorTemplate`, `Actor`, `Tag`, `EgressPolicy`, `AccessPolicy`) live in PostgreSQL behind `ate-api-server`'s gRPC Control API (`api/ateapi/v1/ateapi.proto`) and are managed with `kubectl ate` or gRPC clients. Agent Substrate is a Cloud Native Computing Foundation sandbox project originally created by Google. ## Consolidated Reference Bundle - [Full Documentation Bundle (llms-full.txt)](https://ate.dev/llms-full.txt): Single-file Markdown compilation of all Agent Substrate documentation. ## Get Started - [Overview](https://ate.dev/docs/get-started/overview/index.md): A high-density, low-latency execution runtime for stateful agent workloads. - [Quickstart & Installation](https://ate.dev/docs/get-started/quickstart/index.md): Deploy Agent Substrate on a local kind cluster and invoke your first stateful actor. ## Concepts - [Architecture](https://ate.dev/docs/concepts/architecture/index.md): The components of Agent Substrate and how actors, workers, and the control plane interact. - [Request Parking](https://ate.dev/docs/concepts/request-parking/index.md): How the atenet router holds requests for suspended actors while they resume. ## Tutorials - [Stateful Counter](https://ate.dev/docs/tutorials/counter/index.md): Preserve in-memory, root filesystem, and durable volume state across actor suspend and resume cycles. - [Interactive Sandbox](https://ate.dev/docs/tutorials/sandbox/index.md): Execute interactive shell commands inside an isolated Alpine container with stateful snapshots. - [Jupyter Notebook](https://ate.dev/docs/tutorials/jupyter/index.md): Run an unmodified Jupyter Notebook container that checkpoints on suspend and resumes on browser access. - [Multi-Template WorkerPool](https://ate.dev/docs/tutorials/multi-template/index.md): Share a single WorkerPool across multiple ActorTemplates and atespaces using label selectors. - [Request Parking](https://ate.dev/docs/tutorials/parking/index.md): Hold and retry inbound requests during momentary WorkerPool saturation instead of failing with 503. - [Pluggable Egress Networking](https://ate.dev/docs/tutorials/egress/index.md): Tunnel and authenticate outbound actor traffic over mTLS using Envoy or agentgateway. - [Claude Code Multiplexing](https://ate.dev/docs/tutorials/claude-code-multiplex/index.md): Multiplex three Claude Code agents onto two worker pods with automatic suspend and resume. ## How-to Guides - [Operator Install](https://ate.dev/docs/guides/operator-install/index.md): Configure the installer with a settings document, and how it resolves flags, environment, and config. - [Database Configuration](https://ate.dev/docs/guides/postgres/index.md): PostgreSQL roles and connections for the bundled database and for bring-your-own databases. - [Authentication](https://ate.dev/docs/guides/authentication/index.md): How clients authenticate to ate-api-server over SPIFFE mTLS or OIDC JWTs. - [Authorization](https://ate.dev/docs/guides/authorization/index.md): How ate-api-server checks every call against an OpenFGA model, and how to manage roles and access. - [CSI Volumes](https://ate.dev/docs/guides/csi-volumes/index.md): [Status: Preview] Attach CSI volumes to actors. - [Deploying CSI Drivers](https://ate.dev/docs/guides/csi-deployment/index.md): [Status: Preview] Deploy CSI drivers for use with Agent Substrate. - [Egress Traffic](https://ate.dev/docs/guides/egress-traffic/index.md): Supported outbound actor protocols, DNS relay filtering, and what actors see when egress is refused. - [Network Egress](https://ate.dev/docs/guides/network-egress/index.md): How atunnel and the egress gateway tunnel, authenticate, and apply policy to outbound actor traffic. - [MITM Egress Interception](https://ate.dev/docs/guides/egress-trust-bundle/index.md): Configure actors to trust the egress gateway's MITM CA for HTTPS header and credential injection. - [Egress Credential Injection](https://ate.dev/docs/guides/egress-credential-injection/index.md): Put secrets into an actor's outbound HTTPS requests without the actor ever holding them. - [Observability](https://ate.dev/docs/guides/observability/index.md): Logs, metrics, and traces for actors and the Agent Substrate components. - [SLOs and Alerting](https://ate.dev/docs/guides/slos-and-alerts/index.md): Define SLIs, SLOs, and Prometheus alerting rules to monitor Agent Substrate in production. - [Rolling Upgrades](https://ate.dev/docs/guides/upgrade/index.md): Runbook for a rolling upgrade of Agent Substrate. - [Actor JWTs](https://ate.dev/docs/guides/actor-jwts/index.md): What an actor JWT contains and how a relying party verifies it. - [Federating Actor JWTs](https://ate.dev/docs/guides/actor-jwt-federation/index.md): Serve the actor JWT issuer publicly and set up a relying party outside the cluster to trust it. - [Rotating the Actor JWT Signing Key](https://ate.dev/docs/guides/actor-jwt-key-rotation/index.md): The rotation steps, how long to wait between them, and replacing a compromised key. - [Dataplane Timeouts](https://ate.dev/docs/guides/dataplane-timeouts/index.md): Substrate dataplane timeouts are tuned to support streaming or long running requests, such as inference. Timeouts for ingress and egress traffic are the same. On the ingress path timeouts are defined for connections and requests between client and actor, and on the egress path between actor and origin server. Internal CONNECT tunnels between Atunnel and Ingress or Egress gateways are transparent to the traffic and do not have configured timeouts. ## Reference - [API Guide](https://ate.dev/docs/reference/api-guide/index.md): Define WorkerPools, ActorTemplates, and SandboxConfigs, and call the Control Plane gRPC API. - [API Reference](https://ate.dev/docs/reference/api/index.md): Reference for the Substrate ate-api-server gRPC API and Kubernetes CRD types. - [Resource Model](https://ate.dev/docs/reference/resource-model/index.md): The resources Agent Substrate exposes through its gRPC and Kubernetes APIs, and how they relate. - [kubectl-ate CLI Reference](https://ate.dev/docs/reference/kubectl-ate/index.md): Manage atespaces, actor templates, actors, snapshots, egress policies, and logs with the kubectl-ate plugin. - [Glossary](https://ate.dev/docs/reference/glossary/index.md): Definitions of core terms, resources, and components across Agent Substrate. - [Version Skew Policy](https://ate.dev/docs/reference/version-skew-policy/index.md): Which component releases may run together, and the order to upgrade them in. - [Sandbox Classes](https://ate.dev/docs/reference/sandbox-classes/index.md): How the gvisor and microvm sandbox classes differ in sizing, capabilities, and snapshots. - [Control Plane gRPC Proto (ateapi.proto)](https://github.com/agent-substrate/substrate/blob/main/api/ateapi/v1/ateapi.proto): Canonical protobuf service and resource definitions for Atespace, ActorTemplate, Actor, Tag, EgressPolicy, AccessPolicy, and Worker. - [WorkerPool CRD](https://github.com/agent-substrate/substrate/blob/main/manifests/ate-install/generated/ate.dev_workerpools.yaml): OpenAPI v3 Kubernetes CustomResourceDefinition schema for `ate.dev/v1` `WorkerPool`. - [SandboxConfig CRD](https://github.com/agent-substrate/substrate/blob/main/manifests/ate-install/generated/ate.dev_sandboxconfigs.yaml): OpenAPI v3 Kubernetes CustomResourceDefinition schema for `ate.dev/v1` `SandboxConfig`. - [CSIDriverConfig CRD](https://github.com/agent-substrate/substrate/blob/main/manifests/ate-install/generated/ate.dev_csidriverconfigs.yaml): OpenAPI v3 Kubernetes CustomResourceDefinition schema for `ate.dev/v1` `CSIDriverConfig`. - [Metrics & Events Registry](https://github.com/agent-substrate/substrate/tree/main/docs/metrics/registry): OpenTelemetry Weaver schema defining emitted metrics, log events, and attributes. ## Security - [Security Overview](https://ate.dev/docs/security/security/index.md): The security scope, extensibility, and core principles of Agent Substrate. - [Threat Model](https://ate.dev/docs/security/threat-model/index.md): Assets, trust boundaries, and threats considered for Agent Substrate. - [Extending Substrate](https://ate.dev/docs/security/extensibility/index.md): Augment or replace the built-in ingress and egress gateways with custom policy enforcement points. ## Optional - [Community](https://ate.dev/docs/project/community/index.md): Connect with the Agent Substrate community on Slack, the mailing list, and weekly sync meetings. - [GitHub Repository](https://github.com/agent-substrate/substrate): Source code, issue tracker, manifests, and release artifacts for Agent Substrate.