O que conta como ocioso
Um sandbox está ocioso enquanto nada acontece nele: nenhuma chamada a ele e nenhum stream aberto, nenhum link aberto, sessão SSH ou requisição a uma das portas dele, nenhum turno de agente rodando e nenhum comando rodando que tenha sido iniciado com keep_awake. Um processo em segundo plano sozinho não o mantém acordado: quando o sandbox pausa, o processo congela com ele e continua ao acordar. Cada servidor olha cada um dos seus sandboxes uma vez por segundo.
Os três timers: pausa, parada e exclusão automáticas
pause_after_idle_seconds, 300 por padrão: um sandbox rodando pausa, com memória e processos guardados, por 30% do preço rodando.stop_after_idle_seconds, 1800 por padrão: um sandbox rodando ou pausado para; os processos terminam, e o disco vai para o armazenamento de objetos por US$ 0,03 por GiB ao mês dos próprios dados.delete_after_idle_seconds, 0 por padrão, ou seja, nunca: um sandbox em qualquer estado é excluído.
Os três correm no mesmo relógio, o tempo desde que algo aconteceu no sandbox pela última vez. Um timer de parada que não vence depois do de pausa faz um sandbox rodando parar sem pausar antes. get_sandbox diz o que o ciclo de vida faz a seguir e quando, em next_state e next_state_time. Você define os timers ao criar um sandbox, muda depois com update_sandbox, e um template pode levá-los para todos os sandboxes criados a partir dele.
from pethost.sandboxes import Lifecycle, Sandboxes, SandboxSettings
sandboxes = Sandboxes() # lê o PETHOST_TOKEN
lifecycle = Lifecycle(
pause_after_idle_seconds=60, # pausado após um minuto ocioso
stop_after_idle_seconds=3600, # parado após uma hora ociosa
delete_after_idle_seconds=7 * 86400, # excluído após uma semana ociosa
)
sandbox = sandboxes.create_sandbox("base", settings=SandboxSettings(lifecycle=lifecycle))
# Trabalho que ninguém chama enquanto roda: keep_awake adia a pausa, por uma hora no máximo.
install = "python3 -m venv env && env/bin/pip install pandas scikit-learn"
sandboxes.run_command(sandbox.sandbox_id, command=install, keep_awake=True, timeout_seconds=3600, wait_seconds=0)id=$(pethost sandbox new --pause-after 1m --stop-after 1h --delete-after 168h)
pethost sandbox run "$id" --keep-awake --timeout 1h -d -- 'python3 -m venv env && env/bin/pip install pandas scikit-learn'Quando um servidor fica sem folga
Um servidor pode pausar ou parar sandboxes antes dos timers. Quando a memória fica curta, ele pausa sandboxes rodando que estão ociosos há um minuto ou mais; quando o disco fica curto, os sandboxes pausados ociosos há mais tempo são parados. Nada se perde em nenhum dos casos: um sandbox pausado acorda como qualquer outro, um parado inicia de novo a partir do disco, e state_message diz por que aconteceu.
Acordar um sandbox parado
Uma chamada a um sandbox parado é recusada por padrão (FAILED_PRECONDITION com Stopped), e uma requisição a uma das portas dele recebe 503, até resume_sandbox iniciá-lo. Com wake_when_stopped ativado, um sandbox parado acorda com uma chamada, um login SSH ou uma requisição a uma porta, como um pausado: em cerca de 0,2 s, ou cerca de 10 s por GiB quando o disco precisa ser buscado de volta do armazenamento de objetos. As vCPUs dele então contam no seu plano enquanto está parado. Serve para um sandbox que um webhook chama de vez em quando.
Quanto custa o tempo ocioso
Nenhum sandbox tem tempo de vida máximo: um mantido acordado roda até você pará-lo, e um deixado em paz custa menos a cada etapa. Pegue um sandbox SMALL em que um agente trabalha 2 horas por dia e que fica ocioso nas outras 22, ao longo de um mês de 30 dias. Pausado enquanto ocioso, ele custa US$ 4,64 de uso: 60 horas a US$ 0,018 e 660 a US$ 0,0054. Deixado rodando, custaria US$ 12,96. Parado enquanto ocioso, com 5 GiB de dados próprios, custa US$ 1,22, mas aí cada início dá boot a partir do disco, sem os processos. A cobrança por segundo diz como cada um desses segundos é contado.
Como se compara
Outros fornecedores limitam quanto tempo um sandbox vive. Como as páginas deles diziam em 21 de novembro de 2026, as sessões do E2B duram até 1 hora no Hobby e 24 horas no Pro, e uma pausa recomeça a contagem; os sandboxes do Modal vivem 5 minutos por padrão e 24 horas no máximo; e as sessões do Vercel Sandbox duram 45 minutos no Hobby e 24 horas no Pro. O Pethost não impõe limite: um sandbox pausa e para pelos timers, e vive até você, ou um timer de exclusão que você definiu, removê-lo.