---
title: "Domaine personnalisé et HTTPS : la doc de while.sh"
url: https://while.sh/fr/docs/briques/domaine-perso/
updated: 2026-11-09
---

# 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.

> Vous, à votre agent : Mets l'appli sur planning.acme.fr.

## Ce que votre agent écrit

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

```yaml titre="while.yaml"
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, et servi dès la preuve, au plus tard à la mise en ligne suivante. Le certificat du domaine est émis à sa première visite.

## Les outils MCP de votre agent

Votre agent s'en occupe avec l'outil `get_app_status`.

## Guides

- [Mettre votre appli sur votre propre nom de domaine, en HTTPS, depuis votre agent IA](/fr/guides/nom-de-domaine/)