Aperçu du déploiement

Jamdesk déploie automatiquement votre documentation sur un sous-domaine *.jamdesk.app. Lorsque vous êtes prêt à passer en production sur votre propre domaine, vous pouvez choisir un sous-domaine personnalisé (comme docs.example.com) ou héberger la documentation sur un sous-chemin de votre site principal : /docs par défaut, ou tout segment personnalisé de votre choix.

Options de déploiement

Hébergement par défaut (sans configuration)

Chaque projet est mis en ligne sur un sous-domaine Jamdesk dès que vous connectez un dépôt. C'est l'option la plus simple pour la documentation interne, les preview, ou les lancements anticipés.

Domaine personnalisé (sous-domaine)

Utilisez votre propre sous-domaine (par exemple, docs.example.com) pour une URL publique à votre image. Vous ajouterez des enregistrements DNS et vérifierez la propriété depuis le dashboard Jamdesk.

Hébergement en sous-chemin

Hébergez la documentation sur un sous-chemin de votre domaine en redirigeant le trafic vers Jamdesk via un proxy : example.com/docs par défaut, ou un segment personnalisé comme example.com/help. Utilisez cette option lorsque vous souhaitez que la documentation se trouve sous votre domaine marketing principal.

Exemple d'extrait de proxy (nginx)

location /docs {
    proxy_pass https://YOUR_SLUG.jamdesk.app;
    proxy_set_header X-Jamdesk-Forwarded-Host $host;
}

location /_next/ {
    proxy_pass https://YOUR_SLUG.jamdesk.app;
}

location /_jd/ {
    proxy_pass https://YOUR_SLUG.jamdesk.app;
}

Pour une configuration complète avec SSL, en-têtes et conseils spécifiques au fournisseur, consultez le guide Hébergement en sous-chemin.

Guides des fournisseurs

Choisissez votre infrastructure pour mettre en œuvre l'hébergement en sous-chemin :

Et ensuite ?