> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gestugroup.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Sous-domaines personnalisés

> Configurer un sous-domaine gestugroup.com pour votre espace partenaire.

## Principe

Un sous-domaine permet à vos utilisateurs d'accéder à la plateforme via une URL personnalisée :

```
https://monentreprise.gestugroup.com
```

au lieu de :

```
https://app.gestugroup.com/?partner=monentreprise
```

L'expérience marque blanche est identique dans les deux cas, mais le sous-domaine renforce la cohérence de votre image.

***

## Prérequis

* Avoir le rôle **Superadmin** (la configuration est faite par l'équipe Gëstu)
* Avoir défini un slug partenaire unique (ex : `monentreprise`)
* Le slug ne peut contenir que des lettres minuscules, des chiffres et des tirets

### Slugs réservés

Les slugs suivants ne peuvent pas être utilisés :

`app`, `www`, `api`, `docs`, `status`, `auth`, `cdn`, `mail`, `admin`

***

## Procédure de configuration

La configuration d'un sous-domaine nécessite deux étapes : une sur OVH (DNS) et une sur Vercel (domaine).

### Étape 1 — OVH : Ajouter l'entrée DNS

1. Connectez-vous à votre espace OVH
2. Allez dans **Zone DNS** du domaine `gestugroup.com`
3. Cliquez sur **Ajouter une entrée**
4. Renseignez :
   * **Type** : `CNAME`
   * **Sous-domaine** : `monentreprise` (votre slug)
   * **Cible** : `cname.vercel-dns.com.` (avec le point final)
5. Validez

### Étape 2 — Vercel : Déclarer le domaine

1. Connectez-vous à Vercel → Projet `sencomply`
2. Allez dans **Settings → Domains**
3. Cliquez sur **Add**
4. Saisissez : `monentreprise.gestugroup.com`
5. Vercel vérifie le CNAME — statut vert en 2 à 5 minutes

<Note>
  La propagation DNS peut prendre jusqu'à 24h dans certains cas, bien qu'elle soit généralement effective en moins de 10 minutes.
</Note>

***

## Vérification

Une fois configuré, testez en ouvrant `https://monentreprise.gestugroup.com` dans votre navigateur. Vous devez voir la page de connexion avec la marque blanche de votre partenaire.

***

## Fallback sans sous-domaine

Les partenaires sans sous-domaine configuré peuvent utiliser l'URL de fallback :

```
https://app.gestugroup.com/?partner=monslug
```

Le thème marque blanche fonctionne identiquement.

***

## Sous-domaines configurés

La liste des sous-domaines actifs est gérée par l'équipe Gëstu. Contactez **[support@gestugroup.com](mailto:support@gestugroup.com)** pour ajouter ou supprimer un sous-domaine.