# 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** : la carte du domaine affiche **Configuration valide**, et ton site répond en HTTPS 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 :

   - **Relier à un environnement**, puis **Production** pour le site principal, ou **Preview** et le nom de la branche, par exemple `staging` pour `staging.exemple.ch` ;
   - **Rediriger vers un domaine** du même projet. Le code par défaut est **308 · Permanente**.

   Pour un domaine racine en production, 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 **Configuration en attente**.

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

   Dès que le domaine est ajouté, la carte ouvre les enregistrements. Chez ton hébergeur DNS, crée un enregistrement **TXT** avec le nom et la valeur du tableau. L’icône à côté de chaque valeur le copie. Si tu as refermé le tableau, **Voir ce qui ne va pas** le rouvre.

   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**

   Dans le même tableau, crée l’enregistrement de trafic 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 que la configuration n’est pas valide. L’icône à côté de **Modifier** relance la vérification tout de suite. Pendant ce temps, la carte affiche **Vérification…**.

   **Vérification** : la pastille passe au vert et le texte devient **Configuration valide**. Le nom du domaine est alors le lien vers le site. Une redirection n’est pas un lien : la colonne indique le code et la cible.

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

| Ce que dit la carte          | Signification                                                                                                                              |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| **Configuration en attente** | La preuve TXT, le trafic ou le certificat manque encore. Le domaine n’est pas servi. **Voir ce qui ne va pas** montre les enregistrements. |
| **Configuration valide**     | La preuve est là, le trafic arrive et le certificat est émis. Le domaine est servi.                                                        |
| **Configuration incorrecte** | Le trafic n’arrive pas à Host, ou le certificat n’a pas pu être émis. **Voir ce qui ne va pas** dit quoi corriger.                         |

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

- La carte reste **Configuration en attente** : 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 : la carte reste **Configuration en attente** et **Voir ce qui ne va pas** dit que le certificat est en cours d’émission. S’il échoue, la carte passe à **Configuration incorrecte**. Vérifie qu’aucun proxy (le nuage orange de Cloudflare, par exemple) ne s’interpose, puis revérifie. Si ça 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.