Domaines personnalisés
Diffusez vos docs depuis votre propre domaine plutôt que *.jamdesk.app. Configuration DNS, SSL et vérification pour sous-domaines et domaines racines.
Diffusez votre documentation depuis votre propre domaine plutôt que le sous-domaine *.jamdesk.app par défaut.
Aperçu de la configuration
Accédez à Settings → Domain de votre projet, puis saisissez votre domaine (par exemple docs.example.com ou example.com).
Ajoutez les enregistrements DNS affichés dans le dashboard à votre fournisseur DNS. Les enregistrements dépendent du type de domaine (voir ci-dessous).
Jamdesk vérifie la propriété et provisionne automatiquement un certificat SSL.
Options d'hébergement
Lors de l'ajout d'un domaine, choisissez votre mode d'hébergement :
Domaine standard
Votre documentation est diffusée directement depuis Jamdesk à votre domaine personnalisé :
docs.example.com → acme.jamdesk.appLe DNS pointe vers Jamdesk, et les certificats SSL sont gérés automatiquement.
Héberger sur /docs (basé sur un proxy, sous-chemin personnalisable)
Votre documentation est diffusée sur un sous-chemin de votre site web existant :
example.com/docs → acme.jamdesk.app/docs/docs est la valeur par défaut ; vous pouvez choisir n'importe quel autre sous-chemin à un seul segment (/help, /guide, etc.) depuis le même bouton bascule. Vous configurez un proxy (Cloudflare, Vercel, nginx, etc.) pour transférer les requêtes de votre sous-chemin choisi vers Jamdesk. Consultez Hébergement par sous-chemin pour des guides de configuration et les règles de choix d'un sous-chemin.
L'activation ou la désactivation de « Host at a subpath », ou la modification du sous-chemin, déclenche un build automatique car la structure d'URL change.
Configuration DNS
Les enregistrements nécessaires dépendent du fait que vous utilisez un sous-domaine ou un domaine apex (racine).
Sous-domaines (par exemple, docs.example.com)
| Type | Nom | Valeur |
|---|---|---|
| CNAME | docs | cname.jamdesk.com |
| TXT | _jamdesk.docs | (affiché dans le dashboard) |
Le champ « Nom » correspond uniquement à la partie sous-domaine. Pour docs.example.com, saisissez docs.
Domaines apex (par exemple, example.com)
| Type | Nom | Valeur |
|---|---|---|
| A | @ | 76.76.21.21 |
| TXT | _jamdesk | (affiché dans le dashboard) |
Les domaines apex utilisent un enregistrement A au lieu d'un CNAME, car les standards DNS (RFC 1034) interdisent les enregistrements CNAME à la racine de la zone.
Les modifications DNS peuvent prendre jusqu'à 48 heures pour se propager, bien que la plupart se terminent en quelques minutes. Vérifiez le statut sur whatsmydns.net.
Vérification
Après l'ajout des enregistrements DNS, Jamdesk effectue automatiquement les actions suivantes :
- Détecte vos enregistrements DNS (CNAME ou enregistrement A, plus TXT)
- Vérifie la propriété du domaine via l'enregistrement TXT
- Provisionne un certificat SSL via Let's Encrypt
- Achemine le trafic vers votre documentation
Vérifiez le statut de vérification dans Settings → Domain. Le statut s'affiche comme :
- Pending (en attente) - En attente de la propagation DNS
- Active (actif) - Domaine vérifié et diffusant le trafic
- Needs Attention (nécessite une attention) - Incompatibilité ou conflit de configuration (vérifiez la notification par e-mail)
- Error (erreur) - Problème de configuration (voir les détails dans le dashboard)
Cliquez sur Refresh dans le dashboard pour vérifier manuellement le statut de vérification.
Certificats SSL
Les certificats SSL sont provisionnés automatiquement et renouvelés avant leur expiration. HTTPS est requis, les requêtes HTTP sont donc redirigées vers HTTPS.
Vous n'avez pas besoin de configurer les certificats manuellement.
Domaines racines
Les domaines racines (apex) comme example.com sont entièrement pris en charge. Le dashboard affiche automatiquement les enregistrements corrects : un enregistrement A pointant vers 76.76.21.21 au lieu d'un CNAME, car les standards DNS interdisent les enregistrements CNAME à la racine de la zone.
Si vous préférez un sous-domaine comme docs.example.com, cela fonctionne aussi.
Domaines multiples
Chaque projet prend en charge un seul domaine personnalisé. Pour plusieurs domaines pointant vers la même documentation :
- Configurez votre domaine principal dans Jamdesk
- Configurez les domaines supplémentaires pour rediriger vers le domaine principal au niveau DNS/CDN
Supprimer un domaine
Pour déconnecter un domaine personnalisé :
- Accédez à Settings → Domain
- Cliquez sur Remove Domain
- Votre documentation reste accessible sur le sous-domaine
*.jamdesk.app
La suppression d'un domaine pour lequel « Host at a subpath » était activé déclenche un build pour mettre à jour les chemins d'URL. Tout sous-chemin personnalisé est effacé avec le domaine ; si vous reconnectez un domaine plus tard, la documentation redémarre sur le /docs par défaut.
Utilisateurs de Cloudflare
Si vous utilisez Cloudflare comme fournisseur DNS :
- Définissez le statut du proxy sur DNS only (icône de nuage gris) pendant la vérification du domaine
- Laissez Vercel gérer le SSL : désactivez « Always Use HTTPS » de Cloudflare pour le sous-domaine des docs
- Une fois la vérification terminée, vous pouvez réactiver le proxy (nuage orange)
Vous utilisez un Cloudflare Worker ? L'enregistrement DNS doit être proxifié (nuage orange) pour que le Worker fonctionne. Utilisez le nuage gris uniquement pendant la vérification, puis revenez en arrière. Consultez Configuration de Cloudflare Workers pour plus de détails.
Dépannage
| Problème | Solution |
|---|---|
| Domaine bloqué sur « En attente » | Vérifiez les enregistrements DNS avec dig (CNAME pour les sous-domaines, A pour l'apex) |
| Erreurs de certificat SSL | Assurez-vous qu'aucun enregistrement CAA ne bloque Let's Encrypt |
| Boucles de redirection | Si vous utilisez Cloudflare, définissez le nuage gris pendant la vérification (voir Utilisateurs de Cloudflare ci-dessus) |
| Le CNAME ne se résout pas | Vérifiez l'enregistrement chez le fournisseur DNS, attendez la propagation |
| Domaine déjà utilisé | Le domaine est enregistré dans Vercel depuis une configuration précédente ; la vérification se termine généralement automatiquement |
Vérifier le DNS avec dig
# Check CNAME record (subdomains)
dig CNAME docs.example.com
# Check A record (apex domains)
dig A example.com
# Check TXT record
dig TXT _jamdesk.example.comPour des diagnostics détaillés, consultez Problèmes DNS.
Le sous-domaine jamdesk.app entre-t-il en concurrence avec mon domaine dans les résultats de recherche ?
Non. Une fois que votre domaine personnalisé est actif, les pages diffusées directement depuis votre
sous-domaine [slug].jamdesk.app incluent un lien canonique pointant vers votre
domaine, de sorte que les moteurs de recherche considèrent votre domaine comme la source unique de vérité
et y consolident tous les signaux de classement.