# Website: Eigene Domain verbinden

{/* AUTO-SYNCED SOURCE: this page lives in apps/app/src/modules/website/docs/ and is mirrored into the docs app by `bun sync:module-docs`. Edit it in the module, not in apps/docs. */}

<Lead>
Deine Website wird erst mit einer **eigenen Domain** öffentlich sichtbar. Das Verbinden besteht aus zwei DNS-Einträgen bei deinem Domain-Anbieter. Das Tool zeigt dir beide Einträge fertig zum Kopieren an; diese Seite erklärt, was dahinter steckt und wo es typischerweise hakt.
</Lead>

## Voraussetzungen

- Du besitzt eine Domain (z.B. bei IONOS, Strato, united-domains, GoDaddy oder Cloudflare registriert).
- Du kannst dich beim Anbieter anmelden und die **DNS-Einträge** der Domain bearbeiten. Dieser Bereich heißt je nach Anbieter DNS, DNS-Verwaltung, Nameserver-Einträge oder Zonen-Editor.

## Schritt für Schritt

1. Öffne im Website-Tool den Bereich **Domain** und trage deine Adresse ein, z.B. `www.mein-buero.de`. Klicke auf **Verbinden**.
2. Das Tool zeigt dir eine Tabelle mit den nötigen DNS-Einträgen:
   - Ein **TXT-Eintrag** beweist, dass die Domain wirklich dir gehört. Name und Wert kopierst du exakt so, wie sie angezeigt werden.
   - Ein **CNAME-Eintrag** (bei www-Adressen) oder **A-Einträge** (bei der Haupt-Domain ohne www) leiten Besucher auf deine Website.
3. Lege beide Einträge bei deinem Domain-Anbieter an. Wichtig bei Cloudflare: den Eintrag auf **DNS only** stellen (graue Wolke), nicht auf Proxied.
4. Zurück im Tool: **Jetzt prüfen** klicken. DNS-Änderungen brauchen üblicherweise 5 bis 15 Minuten, in Einzelfällen länger. Schlägt die Prüfung fehl, sagt dir das Tool konkret, welcher Eintrag fehlt oder falsch zeigt.
5. Sobald die Domain bestätigt ist, wird das **SSL-Zertifikat automatisch ausgestellt**. Du musst nichts kaufen und nichts verlängern.

## www und Haupt-Domain

Verbinde am besten **beide** Varianten (`mein-buero.de` und `www.mein-buero.de`) und markiere eine als **primär**. Die primäre Adresse erscheint bei Google und in geteilten Links; die andere leitet automatisch dauerhaft dorthin weiter. So verlierst du keine Besucher, egal welche Variante jemand eintippt.

## Häufige Fehlerquellen

- **Der TXT-Wert wurde verändert.** Manche Anbieter setzen den Wert automatisch in Anführungszeichen; das ist in Ordnung. Kürzen oder Leerzeichen ergänzen ist es nicht.
- **Cloudflare-Proxy aktiv.** Der orangene Wolken-Modus verschleiert das Ziel; stelle den Eintrag auf DNS only.
- **Alter A-Eintrag blieb stehen.** Wenn die Domain vorher auf einen anderen Anbieter zeigte, lösche die alten A- oder CNAME-Einträge für denselben Namen. Es darf nur ein Ziel geben.
- **Zu früh geprüft.** Nach dem Speichern beim Anbieter ein paar Minuten warten und erneut prüfen. Das Tool wiederholt die Prüfung so oft du willst.

## Umzug einer bestehenden Website

Zeigte die Domain bisher auf eine alte Website (z.B. WordPress), geht sie mit dem Umstellen der DNS-Einträge sofort auf die neue. Richte davor unter **SEO** die Weiterleitungen der alten Adressen ein, damit Google-Rankings und gesetzte Links weiter funktionieren. Details in der SEO-Hilfe.