# Domaines Cette page donne les valeurs exactes des enregistrements, les statuts et les règles de propriété. Pour brancher un domaine pas à pas, voir [Brancher un domaine](/docs/guides/brancher-un-domaine/). ## Enregistrements DNS Deux enregistrements, chez ton hébergeur DNS : un TXT de preuve, et un trafic qui arrive sur Host. | Enregistrement | Nom | Valeur | Quand | | -------------- | ---------------------- | --------------------------------------- | --------------------------------------------- | | **TXT** | `_agenthost.` | Le jeton affiché dans la console | Toujours : prouve que le domaine t’appartient | | **CNAME** | `` | La cible affichée dans la console | Pour un sous-domaine, comme `www` | | **A** | `` | L’adresse IPv4 affichée dans la console | Pour un domaine racine, comme `exemple.ch` | Le CNAME ne peut pas être posé sur la racine d’un domaine : le DNS l’interdit. Pour un domaine racine, utilise le A. Les valeurs peuvent changer. La console affiche toujours les valeurs à utiliser : suis-les plutôt qu’une valeur copiée d’une ancienne page. L’icône à côté du nom et de la valeur les copie. Dans **Modifier**, la même icône copie le domaine. ## Statuts | Ce que dit la carte | Signification | Servi ? | | ---------------------------- | --------------------------------------------------------- | ------- | | **Configuration en attente** | Le TXT, le trafic ou le certificat manque | Non | | **Configuration valide** | Le TXT est là, le trafic arrive et le certificat est émis | Oui | | **Configuration incorrecte** | Le trafic n’arrive pas à Host, ou le certificat a échoué | Non | Une carte qui n’est pas **Configuration valide** a le bouton **Voir ce qui ne va pas** : il ouvre les enregistrements encore en attente, ou l’erreur du certificat. Un domaine valide est revérifié chaque jour. Si le TXT disparaît, une seconde vérification a lieu une heure plus tard. Si elle échoue aussi, la carte repasse en attente et le domaine n’est plus servi. La vérification se relance toutes les 15 minutes tant que la configuration n’est pas valide. L’icône à côté de **Modifier** la relance tout de suite. Une configuration déjà valide reste valide pendant cette revérification. ## Certificat HTTPS Dès que le DNS est bon, Host demande un certificat HTTPS. Il se renouvelle seul. La carte n’affiche pas la date d’échéance. Tant que le certificat n’est pas émis, elle reste **Configuration en attente**. S’il échoue, elle passe à **Configuration incorrecte**. Un certificat n’est émis que pour un domaine dont le trafic arrive bien. ## Usages La colonne à droite du nom dit ce que le domaine sert. **Modifier** change ce choix, ou retire le domaine. | Colonne | Ce qui est servi | | ----------- | -------------------------------------------------------------------------------------------- | | Production | Le dernier déploiement de production prêt | | Preview | La dernière preview prête de la branche affichée en dessous, par exemple `staging` | | Redirection | Un autre domaine du même projet, avec le code et la cible en dessous. Le chemin est conservé | Dans **Ajouter un domaine** ou **Modifier**, ce choix s’appelle **Relier à un environnement** (Production ou Preview) ou **Rediriger vers un domaine**. Une redirection vise un domaine du même projet qui sert un site. Une redirection ne peut pas pointer vers une autre redirection. Pour un domaine racine en production, la case **Ajouter aussi [www](http://www).** crée `www` en redirection permanente vers le domaine racine. ## Codes de redirection | Code | Type | Méthode conservée | | ----- | ----------------------- | ----------------- | | `308` | Permanente (par défaut) | Oui | | `301` | Permanente | Non | | `307` | Temporaire | Oui | | `302` | Temporaire | Non | Préfère `308` ou `307` : elles conservent la méthode et le corps de la requête. ## Propriété - La preuve TXT l’emporte. Une revendication non prouvée par une autre organisation ne bloque pas le propriétaire réel : l’organisation qui pose le TXT obtient le domaine. - Deux TXT prouvés en même temps : le premier prouvé garde le domaine. - Les noms de la plateforme ne peuvent pas être ajoutés comme domaine client : Host répond « Ce domaine appartient à la plateforme. » ## Limites | Limite | Valeur | | ----------------------------------------- | ------------------------------------ | | Domaines par organisation | 50 | | Vérifications de domaine | 20 par minute, avec des rafales de 5 | | Revendications concurrentes d’un même nom | 10 au plus | Voir [Limites](/docs/reference/limites/). ## Propagation DNS Un enregistrement neuf peut mettre de quelques minutes à quelques heures à apparaître. La vérification interroge des résolveurs DNS publics. Si aucun résolveur ne répond, le statut ne change pas.