Ce qui compte comme inactif
Une sandbox est inactive tant que rien ne s’y passe : aucun appel vers elle ni flux ouvert, aucun lien ouvert, aucune session SSH ni requête vers l’un de ses ports, aucun tour d’agent en cours, et aucune commande en cours lancée avec keep_awake. Un processus en arrière-plan ne suffit pas à la garder éveillée : quand la sandbox se met en pause, le processus est figé avec elle et reprend au réveil. Chaque serveur examine chacune de ses sandboxes une fois par seconde.
Les trois délais : pause, arrêt et suppression automatiques
pause_after_idle_seconds, 300 par défaut : une sandbox active se met en pause, sa mémoire et ses processus gardés, à 30 % de son prix d’exécution.stop_after_idle_seconds, 1800 par défaut : une sandbox active ou en pause s’arrête ; ses processus prennent fin, et son disque part en stockage objet à 0,03 $ par GiB et par mois de ses propres données.delete_after_idle_seconds, 0 par défaut, c’est-à-dire jamais : une sandbox, quel que soit son état, est supprimée.
Les trois suivent une seule horloge, le temps écoulé depuis que quelque chose s’est passé pour la dernière fois dans la sandbox. Un délai d’arrêt inférieur ou égal au délai de pause arrête une sandbox active sans la mettre en pause d’abord. get_sandbox dit ce que fera ensuite le cycle de vie, et quand, dans next_state et next_state_time. Vous réglez les délais en créant une sandbox, vous les changez ensuite avec update_sandbox, et un template peut les transmettre à chaque sandbox créée à partir de lui.
from pethost.sandboxes import Lifecycle, Sandboxes, SandboxSettings
sandboxes = Sandboxes() # lit PETHOST_TOKEN
lifecycle = Lifecycle(
pause_after_idle_seconds=60, # en pause après une minute d'inactivité
stop_after_idle_seconds=3600, # arrêtée après une heure d'inactivité
delete_after_idle_seconds=7 * 86400, # supprimée après une semaine d'inactivité
)
sandbox = sandboxes.create_sandbox("base", settings=SandboxSettings(lifecycle=lifecycle))
# Un travail que personne n'appelle pendant qu'il tourne : keep_awake retient la pause, une heure au plus.
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'Quand un serveur manque de ressources
Un serveur peut mettre en pause ou arrêter des sandboxes avant leurs délais. Quand sa mémoire vient à manquer, il met en pause les sandboxes actives inactives depuis une minute ou plus ; quand son disque vient à manquer, il arrête les sandboxes en pause inactives depuis le plus longtemps. Rien n’est perdu dans un cas comme dans l’autre : une sandbox en pause se réveille comme les autres, une sandbox arrêtée redémarre depuis son disque, et state_message dit pourquoi c’est arrivé.
Réveiller une sandbox arrêtée
Un appel vers une sandbox arrêtée est refusé par défaut (FAILED_PRECONDITION avec Stopped), et une requête vers l’un de ses ports reçoit une réponse 503, jusqu’à ce que resume_sandbox la démarre. Avec wake_when_stopped activé, une sandbox arrêtée se réveille à un appel, une connexion SSH ou une requête vers un port, comme une sandbox en pause : en 0,2 s environ, ou en 10 s environ par GiB quand son disque doit être rapatrié du stockage objet. Ses vCPU comptent alors dans votre offre même quand elle est arrêtée. Cela convient à une sandbox qu’un webhook appelle de temps en temps.
Ce que coûte le temps d’inactivité
Aucune sandbox n’a de durée de vie maximale : une sandbox gardée éveillée tourne jusqu’à ce que vous l’arrêtiez, et une sandbox laissée à elle-même coûte moins à chaque étape. Prenez une sandbox SMALL dans laquelle un agent travaille 2 heures par jour et qu’il laisse inactive les 22 autres, sur un mois de 30 jours. En pause pendant l’inactivité, elle coûte 4,64 $ de consommation : 60 heures à 0,018 $ et 660 à 0,0054 $. Laissée active, elle coûterait 12,96 $. Arrêtée pendant l’inactivité, avec 5 GiB de ses propres données, elle coûte 1,22 $, mais chaque démarrage la relance alors depuis son disque, sans ses processus. La facturation à la seconde explique comment chacune de ces secondes est comptée.
Face aux autres
D’autres fournisseurs limitent la durée de vie d’une sandbox. D’après leurs pages au 21 novembre 2026, les sessions d’E2B durent jusqu’à 1 heure sur Hobby et 24 heures sur Pro, une pause remettant le compteur à zéro ; les sandboxes de Modal vivent 5 minutes par défaut et 24 heures au plus ; et les sessions de Vercel Sandbox durent 45 minutes sur Hobby et 24 heures sur Pro. Pethost ne fixe aucune limite : une sandbox se met en pause et s’arrête selon ses délais, et vit jusqu’à ce que vous la supprimiez, vous ou un délai de suppression que vous avez réglé.