O que uma pausa guarda
Um sandbox pausado guarda a memória, os processos e o disco no disco do servidor. Um dev server mantém a porta aberta, uma sessão Python mantém as variáveis, a conversa de um agente de código fica onde estava, e um build pela metade continua de onde parou. Você pausa um sandbox com uma chamada, pause_sandbox, ou deixa o timer de ociosidade fazer isso: por padrão, depois de 5 minutos sem nada acontecer nele.
O que o acorda
Qualquer coisa que chegue até ele: um comando, uma leitura ou escrita de arquivo, um stream aberto, um prompt a um agente, um login SSH ou uma requisição a uma das portas dele. Você nunca precisa retomá-lo antes: a chamada que precisa dele o acorda e recebe a resposta. resume_sandbox existe para quando você o quer rodando sem nada para fazer.
Medido nos nossos servidores: uma retomada leva 41 ms no servidor e 124 ms pela API; um comando enviado a um sandbox pausado responde em 80 ms, com o despertar incluído; e uma visita à URL de preview de um sandbox pausado leva cerca de 200 ms.
Como a pausa e a retomada funcionam
Uma pausa faz o guest gravar os sistemas de arquivos, pausa a VM e tira um snapshot diferencial: só a memória que a VM escreveu desde o último snapshot é gravada, e as sequências de páginas que só têm zeros ficam de fora. Logo depois de uma criação, uma pausa levou 52 ms na mediana para um sandbox SMALL e 85 ms para um LARGE, pela API.
Um sandbox pausado mantém o lugar no servidor: o servidor guarda a memória de que o despertar vai precisar, então acordar nunca é recusado por falta de espaço. Por isso ele só retoma ali, no mesmo Firecracker, processador e base, e por isso uma pausa custa 30% do preço rodando, e não zero.
from pethost.sandboxes import Sandboxes
sandboxes = Sandboxes() # lê o PETHOST_TOKEN
sandbox = sandboxes.create_sandbox("base")
# Um processo servidor; a chamada responde quando ele escuta na porta 8000.
sandboxes.run_command(sandbox.sandbox_id, command="python3 -m http.server 8000", wait_for_port=8000)
sandboxes.pause_sandbox(sandbox.sandbox_id) # memória, processos e disco guardados no servidor
# Esta chamada o acorda, e o mesmo processo servidor responde.
page = sandboxes.run_command(sandbox.sandbox_id, command="curl -s localhost:8000 | head -n 1")
print(page.stdout)id=$(pethost sandbox new)
pethost sandbox run "$id" -d --wait-for-port 8000 -- python3 -m http.server 8000
pethost sandbox pause "$id"
pethost sandbox run "$id" -- 'curl -s localhost:8000 | head -n 1' # acorda o sandboxQuanto custa um sandbox pausado
Um sandbox pausado é cobrado por segundo inteiro, a 30% do preço rodando do tamanho dele, sem mínimo: US$ 0,0054 por hora para SMALL, até US$ 0,0432 para XLARGE. O tempo rodando nunca vira tempo pausado, e nenhum segundo conta duas vezes. Quando reiniciamos a máquina de um servidor, os sandboxes rodando nela são pausados e retomados depois, e esses segundos não custam nada.
Pausar ou parar
Parar é o outro jeito de guardar um sandbox que você não está usando. A pausa o deixa pronto; parar o deixa barato:
| Pausado | Parado | |
|---|---|---|
| Onde fica | No disco do servidor | No armazenamento de objetos |
| O que fica guardado | Memória, processos e disco | O disco; os processos terminam |
| Preço, SMALL | US$ 0,0054 por hora | US$ 0,03 por GiB ao mês dos próprios dados |
| De volta a rodar | Cerca de 0,1 s, na próxima chamada | Cerca de 0,2 s por resume_sandbox, ou cerca de 10 s por GiB quando o disco é buscado de volta |
Por padrão, um sandbox é parado depois de 30 minutos ocioso, pausado ou não; o ciclo de vida diz como mudar isso.
Limites
O tamanho de um sandbox pausado não pode mudar: um novo tamanho é recusado até ele ser retomado ou parado. As vCPUs dele contam no limite do seu plano enquanto está pausado, como as de um sandbox rodando. Quando o disco do servidor fica curto, os sandboxes pausados ociosos há mais tempo são parados antes, com o disco guardado, e state_message diz isso. Quando o uso incluído e o saldo de um espaço de trabalho acabam, os sandboxes pausados dele são parados.
Como se compara
Como as páginas deles diziam em 21 de novembro de 2026: o E2B também guarda a memória e não cobra nada enquanto um sandbox está pausado, mas cobra US$ 0,1656 por hora rodando por 2 vCPU e 4 GiB, contra US$ 0,018 aqui, e a documentação dele dá cerca de 4 segundos por GiB de memória para uma pausa e cerca de 1 segundo para uma retomada. O Daytona só pausa a classe de VM Linux dele, e enquanto pausado cobra só o disco. O boat.dev não tem pausa: parar remove a VM e guarda o disco.