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

# Domaine personnalisé

> Connectez votre propre domaine à votre boutique Komerza

Pour utiliser un domaine personnalisé avec votre boutique Komerza, vous devez utiliser **Cloudflare DNS**. Cloudflare fournit les fonctionnalités de proxy et de gestion DNS nécessaires au bon fonctionnement des domaines personnalisés.

<Steps>
  <Step title="Créer un compte Cloudflare">
    Si vous n'avez pas encore de compte Cloudflare, créez-en un sur [dash.cloudflare.com/sign-up](https://dash.cloudflare.com/sign-up).
  </Step>

  <Step title="Ajouter votre domaine à Cloudflare">
    Une fois votre compte créé :

    1. Connectez-vous à votre tableau de bord Cloudflare
    2. Cliquez sur **Ajouter un site**
    3. Saisissez votre nom de domaine (ex. `votreboutique.com`)
    4. Sélectionnez le plan **Gratuit** (ou tout autre plan souhaité)
    5. Cloudflare analysera vos enregistrements DNS existants
    6. Passez à l'étape suivante où Cloudflare vous fournira des serveurs de noms

    Cloudflare vous attribuera deux serveurs de noms. Ils ressemblent généralement à ceci :

    ```
    aaron.ns.cloudflare.com
    bella.ns.cloudflare.com
    ```

    <Note>
      Vos serveurs de noms attribués seront différents. Assurez-vous de copier les serveurs de noms exacts affichés dans votre tableau de bord Cloudflare.
    </Note>
  </Step>

  <Step title="Mettre à jour les serveurs de noms de votre domaine">
    Vous devez pointer votre domaine vers les serveurs de noms de Cloudflare auprès de votre registraire de domaine.

    <Tabs>
      <Tab title="Namecheap">
        1. Connectez-vous à votre [compte Namecheap](https://www.namecheap.com/)
        2. Accédez à **Liste de domaines** dans la barre latérale gauche
        3. Cliquez sur **Gérer** à côté de votre domaine
        4. Faites défiler jusqu'à la section **Serveurs de noms**
        5. Cliquez sur le menu déroulant et sélectionnez **DNS personnalisé**
        6. Saisissez vos serveurs de noms Cloudflare :
           * **Serveur de noms 1** : Votre premier serveur de noms Cloudflare (ex. `aaron.ns.cloudflare.com`)
           * **Serveur de noms 2** : Votre deuxième serveur de noms Cloudflare (ex. `bella.ns.cloudflare.com`)
        7. Cliquez sur la **coche verte** pour enregistrer vos modifications
      </Tab>

      <Tab title="Autres registraires">
        Le processus est similaire pour la plupart des registraires de domaine :

        1. Connectez-vous au panneau de contrôle de votre registraire
        2. Accédez aux paramètres de votre domaine ou à la gestion DNS
        3. Recherchez les paramètres **Serveurs de noms** ou **Serveurs DNS**
        4. Passez des serveurs de noms par défaut aux **Serveurs de noms personnalisés**
        5. Saisissez les deux serveurs de noms Cloudflare qui vous ont été fournis
        6. Enregistrez vos modifications

        Si vous n'êtes pas sûr de la procédure avec votre registraire, recherchez « \[Votre registraire] changer les serveurs de noms » ou contactez leur assistance.
      </Tab>
    </Tabs>
  </Step>

  <Step title="Configurer le DNS dans Cloudflare">
    Une fois vos serveurs de noms mis à jour et Cloudflare affichant votre domaine comme actif :

    1. Accédez à votre domaine dans le tableau de bord Cloudflare
    2. Cliquez sur **DNS** dans la barre latérale gauche
    3. Cliquez sur **Ajouter un enregistrement**
    4. Configurez l'enregistrement :
       * **Type** : `CNAME`
       * **Nom** : `@` (ou saisissez un sous-domaine comme `boutique` pour `boutique.votredomaine.com`)
       * **Cible** : `fallback.mykomerza.com`
       * **Statut du proxy** : **Proxyfié** (icône de nuage orange - requis !)
    5. Cliquez sur **Enregistrer**

    <Warning>
      **Important** : Assurez-vous que le statut du proxy affiche l'icône de nuage orange (Proxyfié). S'il affiche un nuage gris (DNS uniquement), cliquez dessus pour activer le proxy. Le domaine personnalisé ne fonctionnera pas sans proxy activé.
    </Warning>

    <Warning>
      **Enregistrements DNS existants** : Si vous avez des enregistrements DNS existants (A, CNAME ou NS) pour le même nom, supprimez-les pour éviter les conflits avant d'ajouter le nouvel enregistrement CNAME.
    </Warning>
  </Step>

  <Step title="(Optionnel) Rediriger www vers votre domaine racine">
    Si vous souhaitez que les visiteurs de `www.votreboutique.com` soient redirigés vers `votreboutique.com`, suivez ces étapes supplémentaires :

    ### Ajouter un enregistrement DNS pour www

    1. Dans les paramètres DNS de Cloudflare, cliquez sur **Ajouter un enregistrement**
    2. Configurez l'enregistrement :
       * **Type** : `A`
       * **Nom** : `www`
       * **Adresse IPv4** : `192.0.2.0` (IP d'espace réservé réservée)
       * **Statut du proxy** : **Proxyfié** (nuage orange)
    3. Cliquez sur **Enregistrer**

    ### Créer une règle de page pour la redirection

    1. Dans Cloudflare, accédez à **Règles** > **Règles de page**
    2. Cliquez sur **Créer une règle de page**
    3. Saisissez le modèle d'URL : `www.votreboutique.com/*`
    4. Cliquez sur **Ajouter un paramètre** et choisissez :
       * **Paramètre** : URL de transfert
       * **Code d'état** : 301 - Redirection permanente
       * **URL de destination** : `https://votreboutique.com/$1`
    5. Cliquez sur **Enregistrer et déployer la règle de page**
  </Step>

  <Step title="Attendre la propagation">
    Les modifications DNS peuvent prendre du temps à se propager sur Internet.

    <Info>
      La propagation DNS prend généralement **24 à 48 heures** pour être complète dans le monde entier, bien qu'elle se produise souvent beaucoup plus rapidement. Pendant ce temps, certains visiteurs peuvent encore voir les anciens paramètres DNS.
    </Info>

    Vous pouvez vérifier si votre DNS s'est propagé en utilisant des outils comme [dnschecker.org](https://dnschecker.org/) ou [whatsmydns.net](https://www.whatsmydns.net/).
  </Step>
</Steps>

## Résolution des problèmes

| Problème                                | Solution                                                                                   |
| --------------------------------------- | ------------------------------------------------------------------------------------------ |
| Domaine non fonctionnel après 48 heures | Vérifiez que l'enregistrement CNAME est correct et que le proxy est activé                 |
| Erreurs de certificat SSL               | Assurez-vous que le mode SSL/TLS de Cloudflare est réglé sur « Full » ou « Full (Strict) » |
| Redirection www non fonctionnelle       | Vérifiez que la règle de page est active et que l'enregistrement A pour www existe         |
| Cloudflare affiche « En attente »       | Vos serveurs de noms ne se sont pas encore propagés - attendez et revérifiez               |
