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

   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.
• 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 : les enregistrements, les codes de redirection et les limites.
• Migrer depuis Vercel : changer le DNS sans coupure.