# Brancher un domaine

Une page sous ton domaine inspire confiance : `status.ton-client.ch` plutôt que `status.hgdc.ch/ton-client`. Tu prouves que le domaine t’appartient, puis tu pointes le sous-domaine vers la page.

**Avant de commencer** : une page de statut publiée, un sous-domaine (`status.ton-client.ch`, pas un domaine racine), et l’accès à la zone DNS chez ton fournisseur.

> **Disponibilité** : cette fonction s’ouvre progressivement. Si l’écran affiche « Bientôt disponible », elle n’est pas encore active sur ton installation, et ce guide ne s’applique pas encore.

## Ajouter le sous-domaine

1. Ouvre ta page dans **Pages de statut**, puis la section **Domaine personnalisé**.
2. Saisis le sous-domaine complet, par exemple `status.ton-client.ch`, et valide.

Un domaine racine (`ton-client.ch`) est refusé : il ne peut pas pointer vers la page par CNAME. Une adresse de la plateforme Status est refusée aussi.

## Créer les enregistrements DNS

Status affiche deux enregistrements à créer chez ton fournisseur DNS, avec les valeurs exactes de l’écran :

| Type      | Nom                                 | Valeur                                   | Rôle                               |
| --------- | ----------------------------------- | ---------------------------------------- | ---------------------------------- |
| **TXT**   | `_hgdc-status.status.ton-client.ch` | `hgdc-status-verify=…` (valeur affichée) | Prouve que le domaine t’appartient |
| **CNAME** | `status.ton-client.ch`              | La cible affichée                        | Envoie le trafic vers la page      |

Le nom du TXT reprend le sous-domaine complet, précédé de `_hgdc-status.`. Copie la valeur telle quelle.

Les modifications DNS prennent parfois plusieurs heures à se propager. Patiente avant de relancer la vérification.

## Vérifier

Status revérifie le domaine 2 minutes, 10 minutes, 1 heure et 6 heures après l’ajout, puis chaque jour. Dès que le TXT et le CNAME sont en place, le domaine passe à l’état vérifié, et la page répond sur ton sous-domaine.

Pour ne pas attendre le prochain contrôle, relance la vérification depuis la page du domaine une fois les enregistrements ajoutés.

## Ce qui peut faire perdre le domaine

Status retire un domaine vérifié après trois contrôles quotidiens ratés de suite. Cette règle protège contre la reprise d’un sous-domaine abandonné. Une demande qui n’a jamais reçu sa preuve TXT expire au bout de 30 jours.

## Si ça ne marche pas

- **« Le TXT de vérification est introuvable. »** L’enregistrement n’est pas en place, ou son nom est faux. Il doit être `_hgdc-status.` suivi du sous-domaine complet.
- **« Le CNAME ne pointe pas encore vers la page. »** Le CNAME pointe ailleurs, ou la propagation n’est pas finie. Relis la cible affichée.
- **« Le domaine n’a pas pu se charger. »** La page ne répond pas sur le sous-domaine : vérifie que la page est publiée et que le CNAME est bon.
- **« Le domaine n’a pas été ajouté. »** Le sous-domaine est déjà utilisé par une autre page. Choisis un autre nom.
- **Le domaine a été retiré.** Trois contrôles quotidiens ont échoué. Remets les enregistrements, puis ajoute le domaine à nouveau.

Voir aussi : [première page de statut](/docs/demarrer/premiere-page/).