> For the complete documentation index, see [llms.txt](https://gitbook.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gitbook.com/docs/documentation/fr/docs-site/custom-domain.md).
# Définir un domaine personnalisé
{% hint style="info" %}
Cette fonctionnalité est disponible sur [les formules de site Premium et Ultimate](https://www.gitbook.com/pricing).
{% endhint %}
{% hint style="warning" %}
Cette page explique comment configurer un domaine et un sous-domaine personnalisés. Si vous souhaitez configurer un sous-répertoire personnalisé (tel que `example.com/docs`), voir la [Définition d’un sous-répertoire personnalisé](/docs/documentation/fr/docs-site/custom-domain/setting-a-custom-subdirectory.md) de votre site.
{% endhint %}
Par défaut, vos sites sont accessibles sur un `[subdomain].gitbook.io` domaine.
Vous pouvez personnaliser cela en définissant un domaine personnalisé, ce qui signifie que votre public peut accéder à votre documentation sur un domaine de votre choix.
{% stepper %}
{% step %}
#### Choisissez un sous-domaine
Lors du choix d'un sous-domaine, vous pouvez soit utiliser `www` ou un sous-domaine personnalisé. Voici quelques sous-domaines couramment utilisés :
* `docs.example.com`
* `help.example.com`
* `developers.example.com`
{% endstep %}
{% step %}
#### Lancez la configuration du domaine personnalisé
Accédez au site pour lequel vous souhaitez définir le domaine personnalisé. Cliquez sur **Paramètres,** puis choisissez **Configurer un domaine personnalisé.**
À partir d'ici, vous verrez une fenêtre dans laquelle vous pourrez saisir le domaine personnalisé que vous avez choisi à la première étape. Saisissez-le, puis cliquez sur **Suivant.**
{% endstep %}
{% step %}
#### Configurez le DNS
À ce stade, vous verrez une fenêtre avec trois champs : **Type, Nom, Cible.**
Ce sont les informations que vous utiliserez pour configurer votre domaine personnalisé chez votre fournisseur DNS. Cela se fait *en dehors* de GitBook, chez le fournisseur que vous utilisez pour votre domaine.
Copiez le contenu des **Nom** et **Cible** champs à utiliser chez votre fournisseur DNS. Chaque fournisseur est différent ; en cas de doute, vérifiez directement auprès de lui comment ajouter cet enregistrement. Vous devriez pouvoir choisir le **Tapez** type d'enregistrement dans une liste chez votre fournisseur.
Après avoir ajouté l'enregistrement, la propagation des changements peut prendre un certain temps. Nous recommandons **d'attendre au moins 1 heure** avant de passer à l'étape suivante. Cliquez sur **Suivant** quand vous êtes prêt.
{% endstep %}
{% step %}
#### Finalisez votre configuration
Une fois l'enregistrement ajouté et propagé, il est temps de passer en ligne ! GitBook vérifiera le domaine, l'enregistrement que vous avez ajouté et configurera automatiquement le certificat SSL pour votre domaine.
Une fois terminé, vous recevrez une notification et pourrez cliquer sur **Terminer**. Vous pouvez également fermer la fenêtre si nécessaire, et nous vous enverrons une notification une fois le processus terminé de notre côté.
{% endstep %}
{% endstepper %}
### Dépannage
La configuration d'un domaine personnalisé peut parfois rencontrer des obstacles. Ci-dessous, nous décrivons les problèmes fréquents rencontrés au cours de ce processus et apportons des solutions détaillées à chacun d'eux.
Erreur SSL : une erreur s'est produite lors du provisionnement de votre certificat SSL.
Lorsqu'un domaine personnalisé est défini pour votre organisation, groupe ou section, nous configurons un certificat SSL de notre côté afin que votre documentation se charge en toute sécurité, via HTTPS.\
\
Cela se fait automatiquement lorsque vous définissez votre domaine personnalisé — vous n'avez pas besoin d'acheter ou de configurer un certificat SSL.
Des erreurs surviennent parfois à ce stade, généralement lorsque l'enregistrement CNAME du domaine personnalisé n'a pas encore propagé.
Dans ces cas, nous pouvons recommander ce qui suit :
1. Vérifiez que votre enregistrement CNAME est correctement configuré.\
Veuillez consulter notre page sur la configuration du DNS pour vous aider.\
Si l'enregistrement CNAME est incorrect, nous ne pourrons pas configurer le certificat SSL et terminer la configuration du domaine personnalisé.
2. Prévoyez ***au moins une heure*** entre la configuration de l'enregistrement CNAME et la finalisation de la configuration du domaine personnalisé.
3. Vérifiez si le CNAME a bien propagé. Vous pouvez essayer d'utiliser un outil de recherche DNS tiers, tel que [WhatsMyDNS](https://www.whatsmydns.net/), pour savoir ce que les serveurs considèrent comme correct pour votre enregistrement CNAME.
4. Si vous utilisez Cloudflare, veuillez confirmer que l'enregistrement n'est pas proxyfié [comme expliqué ici](https://developers.cloudflare.com/fundamentals/setup/manage-domains/pause-cloudflare/#disable-proxy-on-dns-records).
Erreur de domaine déjà connecté : votre sous-domaine est déjà configuré pour un contenu différent.
Un domaine personnalisé attribué à un site doit être unique. Tenter d'utiliser le même domaine personnalisé à plusieurs endroits entraînera une erreur.
Si cela se produit, vous pouvez cliquer sur le lien dans le message d'erreur pour consulter le contenu auquel le domaine personnalisé est déjà connecté. Cela peut vous aider à décider de la suite à donner.
Il est également possible que vous n'ayez pas accès au contenu — dans ce cas, contactez l'équipe d'assistance, qui pourra vous aider pour les prochaines étapes.
La solution à cette erreur sera toutefois toujours l'une des deux suivantes :
1. Choisir un domaine personnalisé différent ; ou
2. Dissocier le domaine personnalisé du contenu auquel il est déjà connecté, puis le reconnecter au nouveau contenu.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://gitbook.com/docs/documentation/fr/docs-site/custom-domain.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.