Qué cuenta como inactivo
Un sandbox está inactivo mientras no pasa nada en él: ninguna llamada a él ni ningún stream abierto, ningún enlace abierto, sesión SSH ni petición a uno de sus puertos, ningún turno de agente en curso y ningún comando en ejecución iniciado con keep_awake. Un proceso en segundo plano por sí solo no lo mantiene despierto: cuando el sandbox se pausa, el proceso se congela con él y sigue al despertar. Cada servidor revisa cada uno de sus sandboxes una vez por segundo.
Los tres temporizadores: pausa, detención y eliminación automáticas
pause_after_idle_seconds, 300 por defecto: un sandbox en ejecución se pausa, con su memoria y sus procesos conservados, al 30 % de su precio en ejecución.stop_after_idle_seconds, 1800 por defecto: un sandbox en ejecución o en pausa se detiene; sus procesos terminan, y su disco pasa al almacenamiento de objetos a 0,03 US$ por GiB al mes de sus propios datos.delete_after_idle_seconds, 0 por defecto, es decir, nunca: un sandbox en cualquier estado se elimina.
Los tres usan un solo reloj, el tiempo desde que pasó algo por última vez en el sandbox. Un temporizador de detención que no supera al de pausa detiene un sandbox en ejecución sin pausarlo antes. get_sandbox dice qué hará el ciclo de vida a continuación y cuándo, en next_state y next_state_time. Configuras los temporizadores al crear un sandbox, los cambias después con update_sandbox, y una plantilla puede llevarlos para cada sandbox creado a partir de ella.
from pethost.sandboxes import Lifecycle, Sandboxes, SandboxSettings
sandboxes = Sandboxes() # lee PETHOST_TOKEN
lifecycle = Lifecycle(
pause_after_idle_seconds=60, # en pausa tras un minuto inactivo
stop_after_idle_seconds=3600, # detenido tras una hora inactivo
delete_after_idle_seconds=7 * 86400, # eliminado tras una semana inactivo
)
sandbox = sandboxes.create_sandbox("base", settings=SandboxSettings(lifecycle=lifecycle))
# Trabajo al que nadie llama mientras se ejecuta: keep_awake aplaza la pausa, una hora como 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'Cuando a un servidor le falta espacio
Un servidor puede pausar o detener sandboxes antes de sus temporizadores. Cuando le falta memoria, pausa los sandboxes en ejecución que llevan un minuto o más inactivos; cuando le falta disco, detiene los sandboxes en pausa que llevan más tiempo inactivos. En ningún caso se pierde nada: uno en pausa despierta como cualquier otro, uno detenido arranca de nuevo desde su disco, y state_message dice por qué pasó.
Despertar un sandbox detenido
Una llamada a un sandbox detenido se rechaza por defecto (FAILED_PRECONDITION con Stopped), y una petición a uno de sus puertos recibe un 503, hasta que resume_sandbox lo inicia. Con wake_when_stopped activado, un sandbox detenido despierta con una llamada, un inicio de sesión SSH o una petición a un puerto, igual que uno en pausa: en unos 0,2 s, o en unos 10 s por GiB si hay que traer su disco de vuelta del almacenamiento de objetos. Sus vCPU cuentan entonces para tu plan mientras está detenido. Sirve para un sandbox al que un webhook llama de vez en cuando.
Cuánto cuesta el tiempo inactivo
Ningún sandbox tiene una vida máxima: uno que se mantiene despierto se ejecuta hasta que lo detienes, y uno que se deja solo cuesta menos en cada paso. Toma un sandbox SMALL en el que un agente trabaja 2 horas al día y que deja inactivo las otras 22, durante un mes de 30 días. En pausa mientras está inactivo, cuesta 4,64 US$ de uso: 60 horas a 0,018 US$ y 660 a 0,0054 US$. Si siguiera en ejecución, costaría 12,96 US$. Detenido mientras está inactivo, con 5 GiB de datos propios, cuesta 1,22 US$, pero entonces cada inicio lo arranca desde su disco, sin sus procesos. La facturación por segundo explica cómo se cuenta cada uno de esos segundos.
Cómo se compara
Otros proveedores limitan cuánto vive un sandbox. Según sus páginas el 21 de noviembre de 2026, las sesiones de E2B duran hasta 1 hora en Hobby y 24 horas en Pro, y una pausa reinicia la cuenta; los sandboxes de Modal viven 5 minutos por defecto y 24 horas como máximo; y las sesiones de Vercel Sandbox duran 45 minutos en Hobby y 24 horas en Pro. Pethost no pone límite: un sandbox se pausa y se detiene según sus temporizadores, y vive hasta que tú, o un temporizador de eliminación que configures, lo elimina.