> ## Documentation Index
> Fetch the complete documentation index at: https://smartac-mintlify-8d29b8e9.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Domaine personnalisé

> Hébergez votre documentation sur un domaine personnalisé avec configuration DNS, certificats TLS automatiques et routage par sous-domaine ou sous-chemin.

Pour héberger votre documentation sur un domaine personnalisé :

1. Ajoutez votre domaine dans votre Dashboard.
2. Configurez les paramètres DNS auprès de votre fournisseur de domaine.
3. Laissez le temps nécessaire au DNS pour se propager et aux certificats TLS d’être automatiquement provisionnés.

<Info>
  Vous souhaitez configurer un sous-chemin comme `example.com/docs` ? Consultez [/docs subpath](/fr/deploy/docs-subpath).
</Info>

<div id="add-your-custom-domain">
  ## Ajoutez votre domaine personnalisé
</div>

1. Accédez à la page [Configuration du domaine personnalisé](https://dashboard.mintlify.com/settings/deployment/custom-domain) dans votre Dashboard.
2. Saisissez votre nom de domaine. Par exemple, `docs.example.com` ou `www.example.com`.
3. Cliquez sur **Ajouter le domaine**.

<Frame>
  <img alt="La page de configuration du domaine personnalisé affichant le champ pour saisir l'URL de votre domaine personnalisé." className="block dark:hidden" src="https://mintcdn.com/smartac-mintlify-8d29b8e9/I27Jxl5et7Ho5QoW/images/domain/add-custom-domain-light.png?fit=max&auto=format&n=I27Jxl5et7Ho5QoW&q=85&s=b5af87b2c8c6afa807830d8eecdb1e34" width="2236" height="608" data-path="images/domain/add-custom-domain-light.png" />

  <img alt="La page de configuration du domaine personnalisé affichant le champ pour saisir l'URL de votre domaine personnalisé." className="hidden dark:block" src="https://mintcdn.com/smartac-mintlify-8d29b8e9/I27Jxl5et7Ho5QoW/images/domain/add-custom-domain-dark.png?fit=max&auto=format&n=I27Jxl5et7Ho5QoW&q=85&s=f17be97480e58ac4471e22fc7bb7e673" width="2236" height="608" data-path="images/domain/add-custom-domain-dark.png" />
</Frame>

<div id="configure-your-dns">
  ## Configurez votre DNS
</div>

1. Sur le site web de votre fournisseur de domaine, accédez aux paramètres DNS de votre domaine.
2. Créez un nouvel enregistrement DNS avec les valeurs suivantes :

```text theme={null}
CNAME | docs | cname.mintlify.builders
```

<Tip>
  Chaque fournisseur de domaine a des méthodes différentes pour ajouter des enregistrements DNS. Consultez la documentation de votre fournisseur de domaine pour des instructions spécifiques.
</Tip>

<Warning>
  N'ajoutez pas et ne modifiez pas votre `CNAME` tant que les deux enregistrements `TXT` de vérification n'apparaissent pas comme vérifiés dans votre dashboard. Chacun s'affiche avec une coche verte lorsque le DNS est correct. Le dashboard vérifie les enregistrements `TXT` avant que le provisionnement du certificat puisse aboutir. Modifier le `CNAME` trop tôt casse fréquemment le HTTPS jusqu'à la fin du provisionnement.

  Si vous migrez un domaine existant et souhaitez aucun temps d'arrêt, publiez d'abord les enregistrements `TXT` de vérification et attendez qu'ils apparaissent comme vérifiés et que TLS soit pré-provisionné avant de pointer le `CNAME` vers Mintlify.
</Warning>

<div id="verification-txt-records">
  ### Enregistrements TXT de vérification
</div>

Après avoir ajouté un domaine personnalisé, le dashboard affiche deux enregistrements `TXT` que vous devez ajouter chez votre fournisseur DNS :

```text theme={null}
TXT | _acme-challenge.<votre-domaine> | <valeur affichée dans votre dashboard>
TXT | _cf-custom-hostname.<votre-domaine> | <valeur affichée dans votre dashboard>
```

L'enregistrement `_acme-challenge` autorise Let's Encrypt à émettre un certificat TLS pour votre domaine, et l'enregistrement `_cf-custom-hostname` vérifie que vous contrôlez le domaine.

Le dashboard interroge le DNS en arrière-plan et marque chaque enregistrement d'une coche verte une fois qu'il vérifie la valeur attendue. Après avoir enregistré les enregistrements chez votre fournisseur DNS, prévoyez un court délai de propagation avant que les statuts ne soient mis à jour.

<div id="dns-propagation">
  ### Propagation du DNS
</div>

Les modifications DNS se propagent généralement en 1 à 24 heures dans le monde entier, mais cela peut prendre jusqu’à 48 heures dans certains cas. Vous pouvez vérifier que votre DNS est correctement configuré avec [DNSChecker](https://dnschecker.org).

Une fois vos enregistrements DNS actifs, votre documentation est d’abord accessible en HTTP. Le HTTPS sera disponible après le provisionnement de votre certificat TLS.

<div id="automatic-tls-provisioning">
  ### Provisionnement automatique de TLS
</div>

Une fois vos enregistrements `TXT` ajoutés et vos enregistrements DNS résolus correctement, un certificat SSL/TLS gratuit est automatiquement généré pour votre site avec Let's Encrypt.

Cette étape s’achève généralement dans les heures qui suivent la propagation DNS, bien que cela puisse prendre jusqu’à 24 heures dans de rares cas. Les certificats sont automatiquement renouvelés avant leur expiration.

<div id="caa-records">
  ### Enregistrements CAA
</div>

Si votre domain utilise des enregistrements CAA (Certification Authority Authorization), vous devez autoriser Let's Encrypt à émettre des certificats pour votre domain. Ajoutez l'enregistrement CAA suivant à vos paramètres DNS :

```text theme={null}
0 problème "letsencrypt.org"
```

<div id="reserved-paths">
  ### Chemins réservés
</div>

Le chemin `/.well-known/acme-challenge` est réservé à la validation de certificats et ne peut pas être redirigé ni réécrit. Si vous avez configuré des redirections ou des réécritures pour ce chemin, l’émission du certificat échoue.

<div id="provider-specific-settings">
  ### Paramètres spécifiques au fournisseur
</div>

<Accordion title="Mode de chiffrement Cloudflare">
  Si Cloudflare est votre fournisseur DNS, vous devez activer le mode « Full (strict) » pour le paramètre de chiffrement SSL/TLS. Désactivez également « Always Use HTTPS » dans vos paramètres Edge Certificates. La redirection HTTPS de Cloudflare empêche Let's Encrypt de valider votre domaine lors de la mise à disposition du certificat.
</Accordion>

<div id="retry-validation">
  ### Relancer la validation
</div>

Après l’ajout d’un enregistrement `TXT` de vérification, la validation du domaine peut entrer dans une période d’attente et les nouvelles tentatives peuvent prendre plusieurs heures. Si vous avez déjà ajouté les enregistrements DNS corrects et que votre domaine reste en attente de validation, relancez la validation manuellement depuis votre Dashboard pour contourner l’attente.

1. Accédez à la page [Configuration du domaine personnalisé](https://dashboard.mintlify.com/settings/deployment/custom-domain) dans votre Dashboard.
2. Repérez votre domaine personnalisé en attente.
3. Cliquez sur **Retry validation**.

N’utilisez cette option qu’après avoir vérifié que vos enregistrements DNS sont corrects. Relancer la validation avec des enregistrements incorrects n’accélère pas le processus.

<div id="set-a-canonical-url">
  ## Définir une URL canonique
</div>

Après avoir configuré votre DNS, définissez une URL canonique pour indiquer aux moteurs de recherche d’indexer votre domaine préféré. Une URL canonique précise aux moteurs de recherche quelle version de votre documentation est la principale. Cela améliore le SEO lorsque votre documentation est accessible via plusieurs URL et évite les problèmes de contenu dupliqué.

Ajoutez la balise meta `canonical` à votre `docs.json` :

```json theme={null}
"seo": {
    "metatags": {
        "canonical": "https://www.your-custom-domain-here.com"
    }
}
```

Remplacez `https://www.your-custom-domain-here.com` par votre domain personnalisé réel. Par exemple, si votre domain personnalisé est `docs.mintlify.com`, vous utiliseriez :

```json theme={null}
"seo": {
    "metatags": {
        "canonical": "https://docs.mintlify.com"
    }
}
```