English
Docs menu

Agent Sandboxes docs · Reference

Limits of Pethost Agent Sandboxes

Updated · 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

SizevCPUsMemoryDiskDisk speedNetwork, each way
SMALL24 GiB10 GiB128 MiB/s, 3,000 operations/s200 Mbit/s
DEFAULT48 GiB20 GiB256 MiB/s, 6,000 operations/s400 Mbit/s
LARGE816 GiB40 GiB512 MiB/s, 12,000 operations/s800 Mbit/s
XLARGE1632 GiB80 GiB1,024 MiB/s, 24,000 operations/s1,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,000Trial
vcpus: vCPUs at once201287003,0004
largest_sizeLARGEXLARGEXLARGEXLARGEDEFAULT
volume_gib: volumes in all100 GiB600 GiB3,500 GiB16,000 GiB10 GiB
template_gib: templates in all5 GiB30 GiB175 GiB800 GiBThe 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.

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.

Planstarts_per_minutestarts_per_hourstarts_per_day
$20363601,200
$100901,2605,040
$5001952,52010,080
$2,0002703,60014,400
Trial1575225

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

Each sandbox

BoundLimitPast it
Labels32INVALID_ARGUMENT
Settings and labels together48 KiBINVALID_ARGUMENT
Volumes mounted, at create only4INVALID_ARGUMENT
Public ports20INVALID_ARGUMENT
Environment variables100, 32 KiB in allINVALID_ARGUMENT
Egress entries, allow and deny100, 255 bytes eachINVALID_ARGUMENT
Runtime calls at once, streams, links and SSH channels included64; a WriteFiles or a ControlDesktop counts 16RESOURCE_EXHAUSTED: end one, or wait
Requests to its ports at once896HTTP 503
New TCP connections out200 a second, after a burst of 1,000; 1,024 openHeld back
DNS questions200 a secondHeld back

Each call

BoundLimit
A request to a sandbox, such as a command with its stdin, or a prompt1 MiB; WriteFiles 17 MiB
A responseAbout 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 answerThe last 32 KiB of stdout and of stderr, with offsets to read on
wait_seconds, and the wait of ResumeSandbox45 s
A connection token or a link3,600 s by default, 86,400 s at most
Copies in one ForkSandbox100
A volume's size1 to 1,000 GiB
ListSandboxes page50 by default, 500 at most

Kept history

WhatKept
Ended commands (GetCommand)The last 100
Events of each kindThe newest 10,000; commands and agent turns recorded 600 a minute at most
Metrics24 hours
A deleted sandbox's record30 days; its events and metrics a day
A request_id24 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.

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