Previews HTTPS

La sandbox n'a pas d'adresse IP publique, mais chaque application web qui y tourne peut être ouverte dans un navigateur, en HTTPS, à l'adresse :

https://<id>-<port>.yorkhost.sh

Par exemple, un serveur sur le port 8080 de la sandbox sbxabcd2345efgh est accessible sur https://sbxabcd2345efgh-8080.yorkhost.sh. C'est l'adresse affichée à la création (Preview) et renvoyée dans preview_url par ssh status@yorkhost.sh.

Ports disponibles

Port	Usage courant
8080	Port par défaut de la preview
3000	Next.js, Express, Rails…
4173	vite preview
4321	Astro
5000	Flask, divers
5173	Vite (serveur de dev)
8000	Django, FastAPI / Uvicorn, python -m http.server
8888	Jupyter

Les autres ports ne sont pas publiés. Pour y accéder depuis votre machine, utilisez un tunnel ssh -L.

Écouter sur 0.0.0.0

Votre serveur doit écouter sur toutes les interfaces (0.0.0.0), pas seulement sur 127.0.0.1 / localhost : c'est l'erreur la plus fréquente. Les agents de code en sont prévenus par le fichier AGENTS.md de /home/agent, mais vérifiez la commande qu'ils lancent.

# Python
python3 -m http.server 8080 --bind 0.0.0.0

# Node.js (Express, Fastify…) : app.listen(8080, '0.0.0.0')

# Next.js
npx next dev -H 0.0.0.0 -p 3000

# Vite
npx vite --host 0.0.0.0 --port 5173

# Uvicorn (FastAPI)
uvicorn app:app --host 0.0.0.0 --port 8000

# Docker : publier le port sur toutes les interfaces
docker run -p 0.0.0.0:8080:80 nginx

Vite : « This host is not allowed »

Les versions récentes de Vite refusent les noms d'hôte inconnus. Autorisez le domaine des previews dans vite.config.js :

export default {
  server: { host: '0.0.0.0', allowedHosts: ['.yorkhost.sh'] },
  preview: { host: '0.0.0.0', allowedHosts: ['.yorkhost.sh'] },
}

Qui peut voir ma preview ?

Toute personne qui connaît l'adresse. La preview est publique, sans mot de passe : c'est pratique pour montrer un résultat, mais n'y exposez ni données personnelles ni interface d'administration sans authentification.

• Les previews sont servies sur le domaine yorkhost.sh, séparé de yorkhost.fr : elles ne partagent aucun cookie avec le site ou l'espace client YorkHost.
• Elles sont marquées noindex : les moteurs de recherche ne les référencent pas.
• Elles ne fonctionnent que pendant que la sandbox tourne (60 minutes, 2 h pour une sandbox créée depuis votre compte).

Pour une mise en ligne durable, avec votre propre nom de domaine, gardez la sandbox en VPS : le VPS a une adresse IP publique.

Messages d'erreur

Message	Cause et solution
Nothing is listening on port 8080 inside sandbox sbx… yet (bind to 0.0.0.0, not 127.0.0.1).	L'application est arrêtée (plantée, ou pas encore démarrée), ou elle n'écoute que sur 127.0.0.1. Vérifiez qu'elle tourne et démarrez-la sur 0.0.0.0. Dans la sandbox, curl -I localhost:8080 montre si elle répond.
Unknown preview address.	Adresse mal formée, ou port absent de la liste ci-dessus.
This sandbox is stopped (its free window is over). Its owner can keep it as a VPS: ssh claim@yorkhost.sh	La durée d'essai gratuite est écoulée.
This sandbox does not exist or has been deleted.	Identifiant inconnu, ou sandbox supprimée.
Temporarily unavailable, retry in a moment.	Incident passager : réessayez quelques secondes plus tard.