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

# Superserve sandboxes

> Run CostGraph workflows and CI jobs in Superserve sandboxes: the key to create, its permissions, and its limits

Superserve sandboxes are isolated cloud environments built on Firecracker microVMs, each launched from a reusable template.

The following table shows what CostGraph runs on this provider.

| Workflows | CI runners | Connect with |
| - | - | - |
| Yes | Yes | Integrations or your own dispatcher |

## Connect

Connect Superserve on Integrations, and CostGraph starts sandboxes in your Superserve account. You don't run anything yourself.

1. In CostGraph, go to **Integrations > Sandbox > Superserve**.

2. Enter these fields:

   * **API key** (`SUPERSERVE_API_KEY`, required): A Superserve API key from Settings > API keys in the Superserve console.

3. Click **Connect**.

Sandbox size comes from the template set as `providerTemplate`.

### Your own dispatcher

To keep the key out of CostGraph or reach a private network, run your own dispatcher instead.
Set `provider` to `superserve` and the preceding fields as environment variables, as described in [Run your own dispatcher](https://docs.costgraph.ai/costgraph/workflows/managed-sandboxes.md#run-your-own-dispatcher).

To see what Superserve costs, connect the [Superserve integration](https://docs.costgraph.ai/costgraph/integrations/superserve.md).

## Key and permissions

SUPERSERVE\_API\_KEY is a Superserve API key (ss\_live\_...) created at console.superserve.ai under Settings > API keys > Create key (shown once). Sent as X-API-Key; per-sandbox file/command calls use a separate short-lived X-Access-Token.

Keys are scoped to a single team, with no per-key permissions or roles.

Sources: [docs.superserve.ai: home](https://docs.superserve.ai), [docs.superserve.ai: api key](https://docs.superserve.ai/api-key.md), [docs.superserve.ai: lifecycle](https://docs.superserve.ai/sandbox/lifecycle.md), [docs.superserve.ai: sandbox](https://docs.superserve.ai/sdk-reference/sandbox.md).

## Limits

* Auto-pause is off unless timeoutSeconds is set; it caps active time per session, not idle time. ([source](https://docs.superserve.ai/sandbox/lifecycle.md))
* Paused sandboxes are kept forever by default; auto-delete window max 30 days. ([source](https://docs.superserve.ai/sandbox/lifecycle.md))
* Max lifetime, vCPU/RAM caps, regions, architecture: not documented. ([source](https://docs.superserve.ai/sdk-reference/sandbox.md))

## Related

* [Supported sandbox providers](https://docs.costgraph.ai/costgraph/workflows/sandbox-providers.md)
* [Run workflows on a managed sandbox provider](https://docs.costgraph.ai/costgraph/workflows/managed-sandboxes.md)
* [Run CI jobs in sandboxes](https://docs.costgraph.ai/costgraph/autopilot/ci-sandboxes.md)


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