L’adresse
Chaque port d’une sandbox a sa propre adresse HTTPS, https://<port>-<sandbox id>.<server> : par exemple https://3000-k3x9q2m7v1c8p4ra.sbx1.sandboxes.pethost.network. Chaque serveur a un enregistrement DNS wildcard et un certificat pour tous les noms en dessous : une nouvelle sandbox n’a besoin d’aucun enregistrement à elle, et ses adresses marchent dès qu’elle démarre.
Le serveur transmet chaque requête à ce qui écoute sur ce port dans la sandbox, y compris sur localhost : un serveur de développement n’a pas besoin de --host 0.0.0.0. HTTP/1.1 et HTTP/2 marchent tous deux, WebSockets compris, et les ports d’une sandbox servent jusqu’à 896 requêtes en même temps. Un serveur de développement qui vérifie l’en-tête Host, comme celui de Vite, doit avoir l’hôte de la prévisualisation dans ses hôtes autorisés.
from pethost.sandboxes import Ingress, PublicPort, Sandboxes, SandboxSettings
sandboxes = Sandboxes() # lit PETHOST_TOKEN
box = sandboxes.create_sandbox(settings=SandboxSettings(
ingress=Ingress(public_ports=[PublicPort(port=3000)])))
sandboxes.run_command(box.sandbox_id, command="python3 -m http.server 3000",
wait_for_port=3000)
print(sandboxes.get_sandbox(box.sandbox_id).settings.ingress.public_ports[0].url)
# https://3000-k3x9q2m7v1c8p4ra.sbx1.sandboxes.pethost.network
private = sandboxes.create_link(box.sandbox_id, port=8080) # un port privé
print(private.url, private.token) # une requête envoie Pethost-Token: <token>pethost sandbox new --name web --public-port 3000
pethost sandbox run web --wait-for-port 3000 -d -- python3 -m http.server 3000
pethost sandbox url web 3000
pethost sandbox url web 8080 --token # un port privé, et son tokenPublic ou privé
Un port listé dans les paramètres ingress de la sandbox est public : quiconque a l’adresse l’ouvre. Une sandbox en liste jusqu’à 20, à sa création ou plus tard, et aucun par défaut.
Tous les autres ports sont privés. Ils ne répondent qu’à une requête qui porte Pethost-Token: <token>, avec un token que create_link crée pour ce seul port, valable une heure par défaut et un jour au plus. Le serveur le vérifie avant que quoi que ce soit ne se réveille et retire l’en-tête, si bien que votre programme ne le voit jamais ; une requête sans token reçoit 401. Une page de n’importe quelle origine peut appeler le port avec son token, puisque le serveur répond au CORS pour lui : le frontend de votre produit peut parler à la sandbox d’un utilisateur sans rendre un port public.
Un onglet de navigateur, un WebSocket ou une image n’envoie pas cet en-tête. Ce qu’une personne ouvre dans un navigateur, c’est un port public, ou un port privé redirigé vers son ordinateur avec ssh -L.
Des URL de prévisualisation qui dorment
Une prévisualisation pour chacun de vos utilisateurs, c’est quelques appels : un template avec le projet et ses dépendances installées, une sandbox qui en part, le serveur de développement lancé par run_command avec wait_for_port, son port public, et un délai de pause court. Quand personne ne regarde, la sandbox se met en pause avec sa mémoire, serveur de développement compris, à 0,0054 $ de l’heure pour SMALL au lieu de 0,018 $. La visite suivante la réveille en 0,2 s environ, et le serveur répond là où il en était. Une sandbox en pause garde sa place sur son serveur : un réveil n’est jamais refusé faute de place.
Une sandbox STOPPED répond 503 sur ses ports, « stopped: resume it », sauf si son cycle de vie indique wake_when_stopped. Une visite la démarre alors, et ses vCPU comptent dans votre offre même quand elle est arrêtée. Quand une sandbox se met en pause et s’arrête.
Limites et prix
Pas de domaine personnalisé : les adresses sont sous le serveur de la sandbox. Jusqu’à 20 ports publics. Les ports transportent HTTP et WebSockets ; un port TCP brut, comme celui d’une base de données, s’atteint avec ssh -L. Les adresses de toutes les sandboxes sont sous un même domaine : le serveur retire donc le Domain de tout cookie qu’une réponse définit, et vous donnez aux cookies de votre application le préfixe __Host-. Les requêtes vers chaque port apparaissent dans les événements de la sandbox, une ligne par minute avec les requêtes, les réponses 5xx et les octets. Un port n’a pas de prix à part : les requêtes gardent la sandbox éveillée, facturée à la seconde au prix de sa taille, et inactive, elle se met en pause.
Face aux autres
Le 21 novembre 2026, boat.dev donnait par défaut à un port une URL contenant un token, jusqu’à 50 ports, et Vercel Sandbox ouvrait jusqu’à 15 ports. Aucun des deux ne mettait une prévisualisation en pause avec sa mémoire : boat.dev n’a pas de pause, et une sandbox Vercel arrêtée ne gardait que son système de fichiers. Une prévisualisation Pethost en pause répond à son visiteur suivant avec le serveur de développement tel qu’il était.