# Brancher un domaine

Ce guide sert ton site sur `www.exemple.ch` ou `exemple.ch`. Host vérifie que le domaine est à toi, attend que le trafic arrive, puis obtient le certificat HTTPS.

**Résultat attendu** : le domaine affiche le statut **Vérifié** et le certificat HTTPS, et ton site répond sur ce domaine.

**Avant de commencer** :

- un projet déployé en production ;
- l’accès à la zone DNS du domaine chez ton hébergeur. Le DNS d’Infomaniak, de Cloudflare ou d’un autre hébergeur fonctionne de la même façon.

1. **Ajoute le domaine au projet**

   Dans le projet, ouvre l’onglet **Domaines** et clique **Ajouter un domaine**. Saisis le nom, par exemple `www.exemple.ch` ou `exemple.ch`.

   Choisis ce que le domaine sert, dans **Mise en ligne du domaine** :

   - la production, pour le site principal ;
   - une branche, par exemple `staging.exemple.ch` pour la branche `staging` ;
   - une redirection vers un autre domaine du même projet.

   Pour un domaine racine, la case **Ajouter aussi [www](http://www).** crée `www` en redirection permanente vers le domaine racine.

   **Vérification** : le domaine apparaît dans la liste avec le statut **En attente des DNS**.

2. **Prouve que le domaine est à toi**

   Chez ton hébergeur DNS, crée un enregistrement **TXT** avec le nom et la valeur affichés sous **Prouver que le domaine est à toi (TXT)**.

   Le nom commence toujours par `_agenthost.`, suivi du domaine. Certains hébergeurs ajoutent le domaine tout seul : saisis alors seulement la partie avant le domaine, par exemple `_agenthost.www`.

3. **Dirige le trafic vers Host**

   Sous **Diriger le trafic vers Host**, crée l’enregistrement indiqué :

   | Domaine                                    | Type      | Nom   | Valeur                                  |
   | ------------------------------------------ | --------- | ----- | --------------------------------------- |
   | Sous-domaine, par exemple `www.exemple.ch` | **CNAME** | `www` | La cible affichée dans la console       |
   | Domaine racine, `exemple.ch`               | **A**     | `@`   | L’adresse IPv4 affichée dans la console |

   Un CNAME ne peut pas être posé sur la racine d’un domaine. Pour un domaine racine, utilise donc le A.

   > **Attention**
   >
   > Supprime les anciens enregistrements A, AAAA ou CNAME qui pointent vers un autre hébergeur sur le même nom. Un enregistrement qui reste peut masquer le nouveau.

4. **Attends la vérification**

   Host revérifie le domaine toutes les 15 minutes tant qu’il n’est pas vérifié. Clique **Vérifier** pour lancer la vérification tout de suite.

   Chaque étape s’affiche : la preuve TXT, le trafic, puis le certificat.

   **Vérification** : le statut passe à **Vérifié**, puis le certificat HTTPS apparaît avec sa date d’échéance.

Ouvre le domaine dans un navigateur : ton site répond en HTTPS.

## Ce que tu n’as pas à faire

- Téléverser un certificat. Host le demande dès que le domaine est vérifié, et le renouvelle seul.
- Redéployer. Un domaine de production sert le dernier déploiement de production prêt.

## Statuts d’un domaine

| Statut                      | Signification                                                                       |
| --------------------------- | ----------------------------------------------------------------------------------- |
| **En attente des DNS**      | La preuve TXT ou le trafic manque encore. Le domaine n’est pas servi.               |
| **Vérifié**                 | La preuve est là et le trafic arrive. Le domaine est servi.                         |
| **Ne pointe pas vers nous** | La preuve TXT est là, mais le trafic n’arrive pas à Host. Corrige le CNAME ou le A. |

Un domaine vérifié est revérifié chaque jour. Si la preuve TXT disparaît, une seconde vérification a lieu une heure plus tard. Si elle échoue aussi, le domaine repasse en attente et n’est plus servi. Garde donc le TXT en place.

## Si ça ne marche pas

- Le domaine reste **En attente des DNS** : vérifie le nom du TXT, qui doit commencer par `_agenthost.`. Un ancien enregistrement peut aussi retarder la propagation. Voir [Dépannage](/docs/guides/depannage/#mon-domaine-reste-en-attente).
- Host refuse le nom avec « Ce domaine appartient à la plateforme » : les domaines de Host et ceux de la plateforme de déploiement ne peuvent pas être utilisés comme domaine client.
- Le certificat n’est pas encore émis : attends que le statut soit **Vérifié**, puis patiente quelques minutes. Si l’erreur « Le certificat HTTPS n’a pas encore pu être émis » persiste, écris à <support@hgdc.ch>.

## Voir aussi

- [Domaines : référence](/docs/reference/domaines/) : les enregistrements, les codes de redirection et les limites.
- [Migrer depuis Vercel](/docs/guides/migrer-depuis-vercel/) : changer le DNS sans coupure.