# Déployer sur un sous-chemin avec Vercel (/fr/deploy/vercel)

<!-- agent-signals: reading_time_min: 2 · est_tokens: 900 · updated: 2026-07-30 -->
Related: [Héberger la documentation sur un sous-chemin](/fr/deploy/docs-subpath.md), [Déployer sur un sous-chemin avec Cloudflare Workers](/fr/deploy/cloudflare.md), [Déployer sur un sous-chemin avec AWS Route 53 et CloudFront](/fr/deploy/route53-cloudfront.md), [Proxy inverse](/fr/deploy/reverse-proxy.md), [Configuration de la Content Security Policy (CSP)](/fr/deploy/csp-configuration.md)

Configurez votre fichier `vercel.json` pour acheminer les requêtes de votre domaine principal vers votre documentation sur un sous-chemin.

<div id="verceljson-file">
  ## Le fichier vercel.json [#le-fichier-verceljson]
</div>

Le fichier `vercel.json` définit la façon dont votre projet est construit et déployé. Il se trouve à la racine de votre projet et contrôle divers aspects de votre déploiement, notamment le routage, les redirections, les en-têtes et les paramètres de build.

Nous utilisons la configuration `rewrites` dans votre fichier `vercel.json` pour faire transiter les requêtes de votre domaine principal vers votre documentation via un proxy.

Les réécritures (`rewrites`) font correspondre les requêtes entrantes à différentes destinations sans modifier l'URL dans le navigateur. Quand quelqu’un visite `yoursite.com/docs`, Vercel récupère en interne le contenu depuis `your-subdomain.mintlify.site/docs`, mais l’utilisateur voit toujours `yoursite.com/docs` dans son navigateur. Cela diffère des redirections, qui envoient les utilisateurs vers une URL complètement différente.

<div id="configuration">
  ## Configuration [#configuration]
</div>

<div id="host-at-docs-subpath">
  ### Héberger sur le sous-chemin `/docs` [#héberger-sur-le-sous-chemin-docs]
</div>

1. Accédez à [Configuration du domaine personnalisé](https://app.mintlify.com/settings/deployment/custom-domain) dans votre Dashboard.
2. Activez le bouton **Host at**.
3. Saisissez votre domaine.
4. Saisissez `docs` comme chemin de base.
5. Cliquez sur **Add domain**.
6. Ajoutez les réécritures suivantes à votre fichier `vercel.json`. Remplacez `[subdomain]` par votre sous-domaine, que vous trouverez à la fin de l’URL de votre Dashboard. Par exemple, `app.mintlify.com/your-organization/your-subdomain` possède un identifiant de domaine `your-subdomain`.

   ```json
   {
     "rewrites": [
       {
         "source": "/docs",
         "destination": "https://[subdomain].mintlify.site/docs"
       },
       {
         "source": "/docs/:match*",
         "destination": "https://[subdomain].mintlify.site/docs/:match*"
       }
     ]
   }
   ```

La configuration `rewrites` fait correspondre le sous-chemin `/docs` sur votre domaine au sous-chemin `/docs` sur votre documentation.

* **`source`** : Le modèle de chemin sur votre domaine qui déclenche la réécriture.
* **`destination`** : L’endroit où la requête doit être transmise en proxy.
* **`:match*`** : Un joker qui capture tous les segments de chemin après votre sous-chemin.

Pour plus d’informations, consultez [Configuring projects with vercel.json: Rewrites](https://vercel.com/docs/projects/project-configuration#rewrites) dans la documentation Vercel.

<div id="host-at-custom-subpath">
  ### Héberger sur un sous-chemin personnalisé [#héberger-sur-un-sous-chemin-personnalisé]
</div>

Pour utiliser un sous-chemin personnalisé (tout chemin autre que `/docs`) :

1. Accédez à la page [Configuration du domaine personnalisé](https://app.mintlify.com/settings/deployment/custom-domain) dans votre Dashboard.
2. Activez le bouton **Host at** et saisissez votre chemin de base. Par exemple, `/docs` ou `/help`.
3. Saisissez votre domaine.
4. Saisissez votre chemin de base.
5. Cliquez sur **Add domain**.

Utilisez ensuite le générateur ci-dessous pour créer votre configuration de réécritures et ajoutez-les à votre fichier `vercel.json`.

Mintlify reconstruit votre documentation pour la servir sur votre chemin de base, vos fichiers de documentation n’ont donc pas besoin de se trouver dans un répertoire correspondant à votre sous-chemin.