> ## 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.

# Benutzerdefinierte Domain

> Verbinden Sie Ihre eigene Domain mit Ihrem Komerza-Shop

Um eine benutzerdefinierte Domain mit Ihrem Komerza-Shop zu verwenden, müssen Sie **Cloudflare DNS** nutzen. Cloudflare stellt die notwendigen Proxy- und DNS-Verwaltungsfunktionen bereit, die für das ordnungsgemäße Funktionieren benutzerdefinierter Domains erforderlich sind.

<Steps>
  <Step title="Bei Cloudflare registrieren">
    Falls Sie noch kein Cloudflare-Konto haben, erstellen Sie eines unter [dash.cloudflare.com/sign-up](https://dash.cloudflare.com/sign-up).
  </Step>

  <Step title="Ihre Domain zu Cloudflare hinzufügen">
    Nachdem Ihr Konto erstellt wurde:

    1. Melden Sie sich bei Ihrem Cloudflare-Dashboard an
    2. Klicken Sie auf **Site hinzufügen**
    3. Geben Sie Ihren Domainnamen ein (z. B. `ihrshop.com`)
    4. Wählen Sie den **Gratis**-Plan (oder einen anderen bevorzugten Plan)
    5. Cloudflare scannt Ihre vorhandenen DNS-Einträge
    6. Fahren Sie mit dem nächsten Schritt fort, wo Cloudflare Ihnen Nameserver bereitstellt

    Cloudflare weist Ihnen zwei Nameserver zu. Diese sehen typischerweise so aus:

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

    <Note>
      Ihre zugewiesenen Nameserver werden anders sein. Stellen Sie sicher, dass Sie die genauen Nameserver aus Ihrem Cloudflare-Dashboard kopieren.
    </Note>
  </Step>

  <Step title="Nameserver Ihrer Domain aktualisieren">
    Sie müssen Ihre Domain bei Ihrem Domain-Registrar auf die Cloudflare-Nameserver zeigen lassen.

    <Tabs>
      <Tab title="Namecheap">
        1. Melden Sie sich in Ihrem [Namecheap-Konto](https://www.namecheap.com/) an
        2. Gehen Sie zur **Domain-Liste** in der linken Seitenleiste
        3. Klicken Sie auf **Verwalten** neben Ihrer Domain
        4. Scrollen Sie zum Abschnitt **Nameserver**
        5. Klicken Sie auf das Dropdown-Menü und wählen Sie **Benutzerdefiniertes DNS**
        6. Geben Sie Ihre Cloudflare-Nameserver ein:
           * **Nameserver 1**: Ihr erster Cloudflare-Nameserver (z. B. `aaron.ns.cloudflare.com`)
           * **Nameserver 2**: Ihr zweiter Cloudflare-Nameserver (z. B. `bella.ns.cloudflare.com`)
        7. Klicken Sie auf das **grüne Häkchen**, um Ihre Änderungen zu speichern
      </Tab>

      <Tab title="Andere Registrare">
        Der Prozess ist bei den meisten Domain-Registraren ähnlich:

        1. Melden Sie sich beim Kontrollpanel Ihres Domain-Registrars an
        2. Navigieren Sie zu den Einstellungen oder der DNS-Verwaltung Ihrer Domain
        3. Suchen Sie nach **Nameserver** oder **DNS-Server**-Einstellungen
        4. Wechseln Sie von den Standard-Nameservern zu **Benutzerdefinierten Nameservern**
        5. Geben Sie beide von Cloudflare bereitgestellten Nameserver ein
        6. Speichern Sie Ihre Änderungen

        Falls Sie unsicher sind, wie Sie Nameserver bei Ihrem spezifischen Registrar ändern, suchen Sie nach „\[Ihr Registrar] Nameserver ändern" oder kontaktieren Sie deren Support.
      </Tab>
    </Tabs>
  </Step>

  <Step title="DNS in Cloudflare konfigurieren">
    Nachdem Ihre Nameserver aktualisiert wurden und Cloudflare Ihre Domain als aktiv anzeigt:

    1. Gehen Sie zu Ihrer Domain im Cloudflare-Dashboard
    2. Klicken Sie auf **DNS** in der linken Seitenleiste
    3. Klicken Sie auf **Eintrag hinzufügen**
    4. Konfigurieren Sie den Eintrag:
       * **Typ**: `CNAME`
       * **Name**: `@` (oder geben Sie eine Subdomain wie `shop` für `shop.ihrshop.com` ein)
       * **Ziel**: `fallback.mykomerza.com`
       * **Proxy-Status**: **Proxied** (oranges Wolken-Symbol - erforderlich!)
    5. Klicken Sie auf **Speichern**

    <Warning>
      **Wichtig**: Stellen Sie sicher, dass der Proxy-Status das orangefarbene Wolken-Symbol (Proxied) anzeigt. Falls ein graues Wolken-Symbol (Nur DNS) angezeigt wird, klicken Sie darauf, um das Proxying zu aktivieren. Die benutzerdefinierte Domain funktioniert ohne aktiviertes Proxying nicht.
    </Warning>

    <Warning>
      **Vorhandene DNS-Einträge**: Falls Sie vorhandene DNS-Einträge (A, CNAME oder NS) für denselben Namen haben, entfernen Sie diese, um Konflikte zu vermeiden, bevor Sie den neuen CNAME-Eintrag hinzufügen.
    </Warning>
  </Step>

  <Step title="(Optional) www auf Ihre Root-Domain umleiten">
    Falls Sie möchten, dass Besucher von `www.ihrshop.com` zu `ihrshop.com` weitergeleitet werden, führen Sie diese zusätzlichen Schritte durch:

    ### DNS-Eintrag für www hinzufügen

    1. Klicken Sie in den Cloudflare-DNS-Einstellungen auf **Eintrag hinzufügen**
    2. Konfigurieren Sie den Eintrag:
       * **Typ**: `A`
       * **Name**: `www`
       * **IPv4-Adresse**: `192.0.2.0` (reservierte Platzhalter-IP)
       * **Proxy-Status**: **Proxied** (orange Wolke)
    3. Klicken Sie auf **Speichern**

    ### Seitenregel für die Weiterleitung erstellen

    1. Gehen Sie in Cloudflare zu **Regeln** > **Seitenregeln**
    2. Klicken Sie auf **Seitenregel erstellen**
    3. Geben Sie das URL-Muster ein: `www.ihrshop.com/*`
    4. Klicken Sie auf **Einstellung hinzufügen** und wählen Sie:
       * **Einstellung**: Weiterleitungs-URL
       * **Statuscode**: 301 - Permanente Weiterleitung
       * **Ziel-URL**: `https://ihrshop.com/$1`
    5. Klicken Sie auf **Seitenregel speichern und bereitstellen**
  </Step>

  <Step title="Auf Propagierung warten">
    DNS-Änderungen können Zeit benötigen, um sich im Internet zu verbreiten.

    <Info>
      Die DNS-Propagierung dauert typischerweise **24–48 Stunden**, um weltweit abgeschlossen zu sein, obwohl sie oft viel schneller erfolgt. Während dieser Zeit können manche Besucher noch die alten DNS-Einstellungen sehen.
    </Info>

    Sie können überprüfen, ob Ihr DNS propagiert wurde, mit Tools wie [dnschecker.org](https://dnschecker.org/) oder [whatsmydns.net](https://www.whatsmydns.net/).
  </Step>
</Steps>

## Fehlerbehebung

| Problem                                   | Lösung                                                                                                    |
| ----------------------------------------- | --------------------------------------------------------------------------------------------------------- |
| Domain funktioniert nach 48 Stunden nicht | Überprüfen Sie, ob der CNAME-Eintrag korrekt ist und der Proxy aktiviert ist                              |
| SSL-Zertifikatsfehler                     | Stellen Sie sicher, dass der SSL/TLS-Modus von Cloudflare auf „Full" oder „Full (Strict)" eingestellt ist |
| www-Weiterleitung funktioniert nicht      | Prüfen Sie, ob die Seitenregel aktiv ist und der A-Eintrag für www vorhanden ist                          |
| Cloudflare zeigt „Ausstehend"             | Ihre Nameserver haben sich noch nicht propagiert – warten Sie und überprüfen Sie erneut                   |