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

# Choose a Sandbox Provider

A Sandbox supplies the cloud execution environment; a Harness runs Agent tasks inside it. Local and hosted describe the control plane location. Both can use these cloud providers. Select required capabilities first, then check evidence for the exact Harness, model protocol, and SDK combination.

## Registered capabilities

Every target below declares files, commands, and private preview. “No” means the current Hexagon connector does not expose that capability; it does not describe all vendor products. This table follows the registry and connectors, not live acceptance results.

| Provider | API provider | Domain allowlist | OCI | Idle strategy |
| - | - | - | - | - |
| [E2B](https://docs.hexagon.autos/en/integrations/sandboxes/e2b.md) | `e2b` | Yes | Public image build | pause / connect |
| [Modal](https://docs.hexagon.autos/en/integrations/sandboxes/modal.md) | `modal` | Yes | Public and private | snapshot / recreate |
| [Blaxel](https://docs.hexagon.autos/en/integrations/sandboxes/blaxel.md) | `blaxel` | No | No | automatic standby |
| [Fly Sprites](https://docs.hexagon.autos/en/integrations/sandboxes/fly-sprites.md) | `sprites` | No | No | automatic standby |
| [Upstash Box](https://docs.hexagon.autos/en/integrations/sandboxes/upstash-box.md) | `upstash` | No | No | persistent pause / resume |
| [Vercel Sandbox](https://docs.hexagon.autos/en/integrations/sandboxes/vercel.md) | `vercel` | No | No | persistent stop / resume |
| [Agent37](https://docs.hexagon.autos/en/integrations/sandboxes/agent37.md) | `agent37` | No | No | stop / start |
| [Boat](https://docs.hexagon.autos/en/integrations/sandboxes/boat.md) | `boat` | No | No | snapshot stop / resume |
| [Freestyle VMs](https://docs.hexagon.autos/en/integrations/sandboxes/freestyle.md) | `freestyle` | No | No | VM pause / start |
| [Fly Machines](https://docs.hexagon.autos/en/integrations/sandboxes/fly-machines.md) | `fly-machines` | No | Public | suspend / start |
| [Instabox](https://docs.hexagon.autos/en/integrations/sandboxes/instabox.md) | `instabox` | No | No | suspend / resume |

## Interpret the conditions

* **Networking:** only E2B and Modal declare network\_allowlist. Unsupported restrictions fail before allocation instead of silently allowing open networking. Account for the actual credential ingress, model, and Tool request paths.
* **OCI:** Modal supports native OCI including private images; Fly Machines uses public images; E2B prepares public images in a Session-owned Template. Resolution, build, and executable Harness compatibility are separate checks. See [OCI integration](https://docs.hexagon.autos/en/integrations/harnesses/oci.md).
* **Pause:** E2B, Freestyle, and Instabox use memory-preserving strategies. Filesystem strategies do not guarantee arbitrary process or memory continuity. Fly Machines allows cold-boot fallback. Modal snapshot/recreate changes the cloud resource ID while preserving Session identity.
* **Automatic standby:** Blaxel and Sprites control standby timing. It is not confirmed explicit suspension by Hexagon. Unobservable compute or billing state is unknown, not inferred from an idle timer.
* **Deletion:** pause, stop, and snapshots are not cleanup. Closing must reconcile compute, associated endpoints, and image-preparation resources as applicable.

Fly Sprites and Fly Machines have different APIs and lifecycles; their configuration is not interchangeable. Daytona is absent from the current public registry. A historical prototype is not support for new connections.

## Configure and validate

1. Select a provider in Console Sandbox configuration, or create a kind=sandbox connection with management-client create\_connection / createConnection. Read that provider's schema and setup\_url; do not reuse another provider's fields.
2. Submit the provider credential as the connection credential, retained in the control plane. Do not put it in Agent environment, project files, or frontend code.
3. Validate, then explicitly enable. Validation scope varies by provider; listing resources does not establish every allocation, image-build, or deletion permission.
4. Preflight with a compatible Harness/model, then verify a real task, files, required preview, and cleanup. Start with [E2B](https://docs.hexagon.autos/en/integrations/sandboxes/e2b.md) or the [first Session](https://docs.hexagon.autos/en/start/first-session.md).
5. Independently verify next-turn auto-wake, retained files, and conversation when using idle transitions. Single-turn success is insufficient.

Template, image, region, CPU, and memory fields depend on the provider schema. Session timeout/idle settings are not a universal machine specification. Editing a connection invalidates validation and disables it; existing Sessions retain pinned configuration. See [connection changes](https://docs.hexagon.autos/en/build/connection-lifecycle.md).

## Evidence and diagnostics

Inspect dates, SDKs, Harness versions, model protocols, and branches in the [execution matrix](https://github.com/NexusFox88/docs/blob/main/resources/testing/execution-matrix.md) and [Harness serverless ledger](https://github.com/NexusFox88/docs/blob/main/resources/testing/evidence/2026-11-19-harness-serverless-matrix.json). Historical success does not cover every current combination or prove current account quota. This page is source-reviewed; no new cloud verification was performed.

Locate failures in authentication, quota, image preparation, allocation, Runtime, model, preview, or cleanup. Preserve the original operation and resource records after a lost create response; allocating another resource does not establish what happened to the first.

Sources: [registry](https://github.com/NexusFox88/docs/blob/main/resources/integrations/sandboxes/registry.ts), [lifecycle strategies](https://github.com/NexusFox88/docs/blob/main/resources/docs/serverless-sessions.md). Next: [choose a combination](https://docs.hexagon.autos/en/integrations/choose.md), [network policy](https://docs.hexagon.autos/en/build/sandbox-policy.md), [reconciliation](https://docs.hexagon.autos/en/operate/reconciliation.md).

## Capability labels and evidence are separate

| Label | How to read this page |
| - | - |
| Supported | The current connector declares the named interface, such as files/commands/preview for all eleven entries. Verify live permissions and the required scenario separately. |
| Conditional | The interface has stated distribution or lifecycle conditions: for example, E2B public OCI preparation, or filesystem recovery without process-memory promises. |
| Unsupported | The current connector lacks the requested interface, shown as “No” above; do not infer a different vendor product is also incapable. |
| Unknown | Evidence cannot establish the requested live behavior, account condition or billing state. Do not turn this into “supported” because another capability passed. |

The “Yes” allowlist cells describe connector support, not a universal hostname/bypass guarantee. OCI cells carry image-distribution conditions. The idle column names the strategy; it is not a cleanup status or proof of memory retention. Use [verified combinations](https://docs.hexagon.autos/en/integrations/verified-combinations.md) for execution and recovery records, and [Sandbox provider contracts](https://github.com/NexusFox88/docs/blob/main/resources/docs/sandbox-providers.md) for configuration and lifecycle details.

Editorial source: the eleven rows and capability flags were compared with the exported `sandboxConnections` registry; strategy descriptions additionally use the lifecycle contract. Registry `evidence` tags remain declarations, not independent proof of each table cell's real journey. A registry or connector change requires rechecking this table and the affected provider page.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.