Aller au contenu
Host

Tape un mot pour chercher dans les pages.

↑↓ Choisir↵ OuvrirÉchap Fermer
Ouvrir Host

Guides

Brancher un domaine

Sers ton site sur ton propre domaine, avec HTTPS automatique, en quelques minutes de configuration DNS.

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

    DomaineTypeNomValeur
    Sous-domaine, par exemple www.exemple.chCNAMEwwwLa cible affichée dans la console
    Domaine racine, exemple.chA@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.

  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 carteSignification
Configuration en attenteLa 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 valideLa preuve est là, le trafic arrive et le certificat est émis. Le domaine est servi.
Configuration incorrecteLe 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.
  • 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