> 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/publish/custom-domain.md).

# Définir un domaine personnalisé

Définissez un domaine personnalisé pour vos sites de documentation

{% hint style="warning" %}
Cette page explique comment configurer un domaine personnalisé et un sous-domaine. Si vous souhaitez configurer un sous-répertoire personnalisé (par exemple `example.com/docs`), consultez la [Définir un sous-répertoire personnalisé](https://gitbook.com/docs/documentation/fr/publish/custom-domain/setting-a-custom-subdirectory.md) page.
{% endhint %}

Par défaut, vos sites sont accessibles à l’adresse `[subdomain].gitbook.io` .

Vous pouvez personnaliser cela en définissant un domaine personnalisé, ce qui permet à votre public d’accéder à votre documentation sur le domaine de votre choix.

{% stepper %}
{% step %}

#### Choisissez un sous-domaine

Pour choisir un sous-domaine, vous pouvez utiliser `www` ou en choisir un personnalisé. Voici quelques sous-domaines couramment utilisés :

* `docs.example.com`
* `help.example.com`
* `developers.example.com`
  {% endstep %}

{% step %}

#### Lancer la configuration du domaine personnalisé

Accédez au site pour lequel vous souhaitez configurer le domaine personnalisé. Cliquez sur **Paramètres**, puis choisissez **Configurer un domaine personnalisé**.

Une fenêtre s’affiche. Saisissez-y le domaine personnalisé choisi à la première étape, puis cliquez sur **Suivant**.
{% endstep %}

{% step %}

#### Configurer le DNS

Une fenêtre comportant trois champs s’affiche alors : **Type, Nom, Cible.**

Vous utiliserez ces informations pour configurer votre domaine personnalisé auprès de votre fournisseur DNS. Cette opération s’effectue *en dehors de* GitBook, chez le fournisseur auprès duquel vous avez enregistré votre domaine.

Copiez le contenu des champs **Nom** et **Cible** pour les utiliser chez votre fournisseur DNS. Chaque fournisseur est différent ; en cas de doute, contactez-le directement pour savoir comment ajouter cet enregistrement. Vous devriez pouvoir choisir le **Type** d’enregistrement dans une liste proposée par votre fournisseur.

Après l’ajout de l’enregistrement, la propagation des modifications peut prendre un certain temps. Nous vous recommandons d’ **attendre au moins 1 heure** avant de passer à l’étape suivante. Cliquez sur **Suivant** lorsque vous êtes prêt.
{% endstep %}

{% step %}

#### Finaliser votre configuration

Après avoir ajouté l’enregistrement et une fois sa propagation effectuée, il est temps de passer en production ! GitBook vérifiera le domaine et l’enregistrement que vous avez ajouté, et configurera automatiquement le certificat SSL pour votre domaine.

Une fois l’opération terminée, vous recevrez une notification et pourrez cliquer sur **Terminer**. Vous pouvez également fermer la fenêtre si nécessaire ; nous vous enverrons une notification lorsque l’opération sera terminée de notre côté.
{% endstep %}
{% endstepper %}

### Modifier ou mettre à jour votre domaine personnalisé

Pour modifier le domaine personnalisé d’un site, ouvrez les **Paramètres** du site dans la barre latérale et cliquez sur **Domaine et URL**. Vous pouvez supprimer le domaine actuel et en ajouter un nouveau, ou modifier la configuration existante.

N’oubliez pas de mettre à jour les paramètres DNS chez votre fournisseur de domaine afin de les faire pointer vers la nouvelle configuration GitBook — le processus est le même que pour la configuration initiale, avec un enregistrement CNAME pointant vers la valeur fournie par GitBook.

### 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 proposons des solutions détaillées pour chacun d’eux.

<details>

<summary>Mon sous-domaine personnalisé ne fonctionne pas.</summary>

Les problèmes de domaine personnalisé sont généralement liés au DNS. Vérifiez votre configuration DNS :

1. Vérifiez que vous avez créé un enregistrement **CNAME** (et non un enregistrement A) pointant vers la valeur fournie par GitBook.
2. Veillez à utiliser le format de sous-domaine (`docs.yoursite.com` ou `www.yoursite.com`).
3. Si vous utilisez Cloudflare, désactivez le proxy (nuage orange) — l’enregistrement doit être défini sur « DNS uniquement ».

Problèmes DNS courants :

* **Enregistrements conflictuels** — supprimez tout enregistrement A, AAAA ou autre existant pour le même sous-domaine.
* **Délais liés au TTL** — la propagation des modifications DNS à l’échelle mondiale peut prendre jusqu’à 48 heures.
* **Enregistrements CAA** — si vous avez des enregistrements CAA, ajoutez `0 issue "pki.goog"` pour autoriser les certificats SSL de GitBook.

Pour tester votre configuration, utilisez un outil de recherche DNS comme [WhatsMyDNS](https://www.whatsmydns.net/#CNAME) pour vérifier que votre enregistrement CNAME pointe vers la bonne adresse GitBook. Si le problème persiste après 48 heures, contactez l’assistance en indiquant votre nom de domaine et la valeur CNAME fournie par GitBook.

</details>

<details>

<summary>Erreur SSL : une erreur s’est produite lors de la provision de votre certificat SSL.</summary>

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 de manière sécurisée, 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.

Il arrive parfois que des erreurs se produisent à cette étape, généralement lorsque l’enregistrement CNAME du domaine personnalisé n’a pas encore été propagé.

Dans ces cas, nous recommandons 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. Attendez ***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 s’est propagé. Vous pouvez utiliser un outil de recherche DNS tiers, comme [WhatsMyDNS](https://www.whatsmydns.net/), pour savoir ce que les serveurs indiquent pour votre enregistrement CNAME.
4. Si vous utilisez Cloudflare, vérifiez que l’enregistrement n’est pas configuré en tant que proxy, [comme expliqué ici](https://developers.cloudflare.com/fundamentals/setup/manage-domains/pause-cloudflare/#disable-proxy-on-dns-records).

</details>

<details>

<summary>Erreur de domaine déjà connecté : votre sous-domaine est déjà configuré pour un contenu différent.</summary>

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 prochaine étape.

Il est également possible que vous n’ayez pas accès au contenu — dans ce cas, contactez l’équipe d’assistance et elle pourra vous aider à déterminer les étapes suivantes.

La solution à cette erreur sera toujours l’une de ces deux choses :

1. Choisissez un autre domaine personnalisé ; ou
2. Dissociez le domaine personnalisé du contenu auquel il est déjà connecté, puis reconnectez-le au nouveau contenu.

</details>


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://gitbook.com/docs/documentation/fr/publish/custom-domain.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
