---
title: "Limits of Pethost Agent Sandboxes | Pethost Agent Sandboxes"
description: "Every bound of Pethost Agent Sandboxes in one place: sizes, plan budgets, start limits, per-sandbox and per-call limits, kept history and the network."
---

[Agent Sandboxes docs](https://pethost.dev/docs/sandboxes/) · Reference

# Limits of Pethost Agent Sandboxes

Updated 21 November 2026 · 3 min read

Every bound of a sandbox and of a workspace, with what happens past it. A limit of your plan is in `Workspace.limits`, and a call past it answers `RESOURCE_EXHAUSTED` with `LimitReached`, naming it. Every other bound here is the same for every workspace.

## Sizes

| Size | vCPUs | Memory | Disk | Disk speed | Network, each way |
| --- | --- | --- | --- | --- | --- |
| SMALL | 2 | 4 GiB | 10 GiB | 128 MiB/s, 3,000 operations/s | 200 Mbit/s |
| DEFAULT | 4 | 8 GiB | 20 GiB | 256 MiB/s, 6,000 operations/s | 400 Mbit/s |
| LARGE | 8 | 16 GiB | 40 GiB | 512 MiB/s, 12,000 operations/s | 800 Mbit/s |
| XLARGE | 16 | 32 GiB | 80 GiB | 1,024 MiB/s, 24,000 operations/s | 1,600 Mbit/s |

The disk and the network are held by the host, at 64 MiB/s, 1,500 disk operations a second and 100 Mbit/s each way per vCPU. All the sandboxes of a server together move 800 Mbit/s at most each way, whatever each one's own rate. A start grants a burst above them, a minute of the disk's and 256 MiB of the network's, which fills again over 10 minutes.

Your plan names the largest size it allows. There are no GPUs. There is no cap on how long a sandbox lives.

## Your workspace

| Bound | $20 | $100 | $500 | $2,000 | Trial |
| --- | --- | --- | --- | --- | --- |
| `vcpus`: vCPUs at once | 20 | 128 | 700 | 3,000 | 4 |
| `largest_size` | LARGE | XLARGE | XLARGE | XLARGE | DEFAULT |
| `volume_gib`: volumes in all | 100 GiB | 600 GiB | 3,500 GiB | 16,000 GiB | 10 GiB |
| `template_gib`: templates in all | 5 GiB | 30 GiB | 175 GiB | 800 GiB | The plan's |

- **vCPUs** count every sandbox that is RUNNING or PAUSED, every STOPPED one with `wake_when_stopped`, and every create, fork or start under way. Stopped sandboxes are not counted, and their number has no limit.
- **Templates:** 10 versions of one name, and one save at a time.
- **Secrets:** 100 a workspace.
- **Raise them** with a larger plan: [billing](https://pethost.dev/docs/sandboxes/billing/#plans).

## Starts

A create, each copy of a fork and the start of a STOPPED sandbox are starts, free of charge, within these limits in any sliding minute, hour and day. A wake of a PAUSED sandbox is never a start.

| Plan | `starts_per_minute` | `starts_per_hour` | `starts_per_day` |
| --- | --- | --- | --- |
| $20 | 36 | 360 | 1,200 |
| $100 | 90 | 1,260 | 5,040 |
| $500 | 195 | 2,520 | 10,080 |
| $2,000 | 270 | 3,600 | 14,400 |
| Trial | 15 | 75 | 225 |

Past one, `LimitReached`'s `retry_time` says when the call fits again.

## Each sandbox

| Bound | Limit | Past it |
| --- | --- | --- |
| Labels | 32 | `INVALID_ARGUMENT` |
| Settings and labels together | 48 KiB | `INVALID_ARGUMENT` |
| Volumes mounted, at create only | 4 | `INVALID_ARGUMENT` |
| Public ports | 20 | `INVALID_ARGUMENT` |
| Environment variables | 100, 32 KiB in all | `INVALID_ARGUMENT` |
| Egress entries, allow and deny | 100, 255 bytes each | `INVALID_ARGUMENT` |
| Runtime calls at once, streams, links and SSH channels included | 64; a WriteFiles or a ControlDesktop counts 16 | `RESOURCE_EXHAUSTED`: end one, or wait |
| Requests to its ports at once | 896 | HTTP 503 |
| New TCP connections out | 200 a second, after a burst of 1,000; 1,024 open | Held back |
| DNS questions | 200 a second | Held back |

## Each call

| Bound | Limit |
| --- | --- |
| A request to a sandbox, such as a command with its stdin, or a prompt | 1 MiB; `WriteFiles` 17 MiB |
| A response | About 64 KiB; `ReadFile` 1 MiB; a screenshot 17 MiB. A file of any size moves through a download or upload link. |
| A command's output in an answer | The last 32 KiB of stdout and of stderr, with offsets to read on |
| `wait_seconds`, and the wait of `ResumeSandbox` | 45 s |
| A connection token or a link | 3,600 s by default, 86,400 s at most |
| Copies in one `ForkSandbox` | 100 |
| A volume's size | 1 to 1,000 GiB |
| `ListSandboxes` page | 50 by default, 500 at most |

## Kept history

| What | Kept |
| --- | --- |
| Ended commands (`GetCommand`) | The last 100 |
| Events of each kind | The newest 10,000; commands and agent turns recorded 600 a minute at most |
| Metrics | 24 hours |
| A deleted sandbox's record | 30 days; its events and metrics a day |
| A `request_id` | 24 hours |

## Network

- Only TCP and DNS leave a sandbox: no UDP, so no QUIC or HTTP/3, and no ping.
- DNS goes only through the sandbox's own resolver, which answers names your egress allows.
- Always refused: private, link-local and shared address ranges, port 25, and HTTP/2 without TLS.
- Ports answer at `https://<port>-<id>.<server>`, over HTTP/1.1 and HTTP/2, WebSockets included.

## Questions

### How long can a sandbox run?

As long as you like: there is no cap on a sandbox's life. Its lifecycle pauses and stops it when idle, unless you turn those timers off.

### Are there GPUs?

No. Every size is CPUs, memory and disk.

### How many sandboxes can I have?

Your plan's vCPUs bound those running or paused at once. Stopped sandboxes have no limit: each costs its stored data.

[PreviousObservability: a sandbox's metrics, events and usage](https://pethost.dev/docs/sandboxes/observability/) [NextErrors of the sandboxes API, and what to do](https://pethost.dev/docs/sandboxes/errors/)

## Try Pethost Agent Sandboxes

A 7-day trial with $1 of usage and 4 vCPUs, with a card. Then a plan from $20 a month, which includes as much usage.

[Start the trial](https://console.pethost.dev/)

Pethost · Stephan Gomer · NIP 1133096755

Pethost

- [Templates](https://pethost.dev/templates/)
- [About](https://pethost.dev/about/)
- [Docs](https://pethost.dev/docs/)
- [Blog](https://pethost.dev/blog/)
- [API](https://pethost.dev/docs/api/)
- [CLI](https://pethost.dev/docs/cli/)
- [Plugin](https://github.com/pethost-dev/plugin)
- [Terms](https://pethost.dev/terms/)
- [Privacy](https://pethost.dev/privacy/)
- [Refunds](https://pethost.dev/refunds/)
- [support@pethost.dev](mailto:support@pethost.dev)

Databases

- [Postgres](https://pethost.dev/postgres/)
- [Valkey](https://pethost.dev/valkey/)

Agent Sandboxes

- [Sandboxes](https://pethost.dev/sandboxes/)
- [Pricing](https://pethost.dev/sandboxes/#pricing)
- [Docs](https://pethost.dev/docs/sandboxes/)
- [API](https://pethost.dev/docs/sandboxes/api/)

Comparisons

- [Coolify vs Dokploy vs CapRover vs Dokku](https://pethost.dev/blog/coolify-vs-dokploy-vs-caprover-vs-dokku/)
- [Coolify Cloud vs Dokploy Cloud](https://pethost.dev/blog/coolify-cloud-vs-dokploy-cloud/)
- [Railway vs Render vs Fly.io pricing](https://pethost.dev/blog/railway-vs-render-vs-fly-io-pricing/)
- [Managed Docker Compose hosting](https://pethost.dev/blog/managed-docker-compose-hosting/)

Alternatives

- [Railway alternatives](https://pethost.dev/blog/railway-alternatives/)
- [Heroku alternatives](https://pethost.dev/blog/heroku-alternatives/)
- [Dokploy alternatives](https://pethost.dev/blog/dokploy-alternatives/)
- [Coolify alternatives](https://pethost.dev/blog/coolify-alternatives/)
- [Render alternatives](https://pethost.dev/blog/render-alternatives/)
- [Sliplane alternatives](https://pethost.dev/blog/sliplane-alternatives/)
