Aller au contenu

Aller au sommaire de la doc

Domaine personnalisé

Votre appli répond à votre adresse, comme planning.acme.fr, avec son certificat HTTPS. Votre agent déclare le domaine, et vous posez les enregistrements DNS qu’il vous donne.

Mis à jour le 21 novembre 2026.

Voir en Markdown

Domaine personnalisé pour son appli, comme planning.acme.fr : la plaque à votre nom vissée sur l’appli, avec son certificat HTTPS

Vous, à votre IA : Mets l’appli sur planning.acme.fr.

Ce que votre agent écrit

Votre agent l’écrit dans while.yaml, à la racine de votre appli :

while.yaml
apiVersion: while/v1
project: my-app
services:
  - name: web
    port: 3000
    domains: [app.exemple.fr]

Quand vous en servir

Servez-vous-en quand l’appli doit vivre à votre adresse.

Comment ça marche

Votre appli répond à votre adresse, comme app.exemple.fr, avec son certificat HTTPS. while vérifie le domaine par un enregistrement DNS, puis le sert et le route vers la bonne version.

Ce qu’il faut savoir

Un sous-domaine pointe vers edge.while.cloud par un CNAME. Un domaine nu (exemple.fr) prend un ALIAS, un ANAME ou un CNAME aplati vers ce même nom, si son fournisseur DNS le permet (Cloudflare, Bunny, OVH…). En dernier recours seulement, il prend à la place les adresses A et AAAA de l’entrée, données avec la preuve (TXT) : elles peuvent changer, un changement est annoncé sur https://app.while.sh/v1/network, et while prévient alors les domaines qui y pointent. Le domaine est vérifié toutes les cinq minutes. Prouvé, il est servi une à deux minutes plus tard, au plus tard à la mise en ligne suivante. Il lui faut sa route, puis son certificat, émis à sa première visite : verify_domain attend jusque-là. Une prévisualisation ne sert que ses adresses de while, sans les domaines de while.yaml.

Les outils MCP de votre agent

Votre agent s’en occupe avec l’outil get_app_status.

Guides

Donnez la phrase à votre IA, elle s’occupe du reste

À donner à votre IA

Lis while.sh/agents et aide-moi à démarrer avec while.

Copier la phrase

En 3 minutes, sans inscription, l’outil a son adresse. Pour le garder, créez votre compte.

Pour un projet d’entreprise, écrivez à l’équipe de while : hello@while.sh