# Custom-Domain verbinden ## Was ist eine Custom-Domain? Standardmäßig ist dein Tenant unter einer Subdomain der Plattform erreichbar, zum Beispiel `mueller-immo.reosa.de`. Mit einer Custom-Domain kannst du stattdessen eine eigene Adresse wie `app.makler-mueller.de` oder `kunden.makler-mueller.de` verwenden. Logins, das Dashboard und alle Tools laufen dann unter deiner eigenen Domain. Für Kund:innen und Teammitglieder wirkt die Plattform wie ein vollständig in deinen Web-Auftritt integrierter Bestandteil. --- ## Voraussetzungen - **Tarif Standard oder höher:** Im Compact-Tarif ist diese Funktion nicht enthalten. Ein Upgrade ist jederzeit möglich. - **Zugriff auf das DNS-Management der Domain:** Du brauchst Zugang zum DNS-Bereich deines Domain-Providers (z.B. IONOS, Strato, Cloudflare, GoDaddy, united-domains). Wenn dein Webdesigner die Domain verwaltet, kläre den Zugriff vorher ab. - **Subdomain statt Apex:** Wir empfehlen eine echte Subdomain wie `app.deine-domain.de`. Apex-Domains (`deine-domain.de` ohne Subdomain) sind technisch eingeschränkt und kollidieren häufig mit der bestehenden Website. --- ## Schritt 1: Domain im Dashboard hinzufügen 1. Gehe zu **Einstellungen > Domains**. 2. Klicke auf **Domain hinzufügen**. 3. Trage die gewünschte Adresse ein, zum Beispiel `app.makler-mueller.de`. 4. Bestätige mit **Domain anlegen**. Nach dem Anlegen siehst du in der Detailansicht den **CNAME-Zielwert**, den du beim DNS-Provider eintragen musst. Das Format sieht typischerweise so aus: ``` app.makler-mueller.de CNAME tenants.reosa.de ``` Der konkrete Zielwert wird im Dashboard angezeigt. Bitte daraus übernehmen, nicht aus dieser Doku. --- ## Schritt 2: DNS-Records setzen 1. Logge dich beim DNS-Provider ein und navigiere zur DNS-Verwaltung deiner Domain. 2. Lege einen neuen **CNAME-Record** an: - **Host / Name:** der Subdomain-Teil, also `app` (nicht die volle Adresse) - **Ziel / Wert:** der im Dashboard angezeigte CNAME-Zielwert - **TTL:** Standard (300 oder 3600 Sekunden). Niedrigere Werte beschleunigen Änderungen, sind aber nicht zwingend nötig 3. Speichern. Wichtig: Falls bereits ein A-Record oder ein anderer CNAME für `app.deine-domain.de` existiert (häufig aus früheren Setups), **muss dieser gelöscht werden**. Sonst schlägt die Verifizierung später fehl, weil die DNS-Antwort uneindeutig wird. --- ## Schritt 3: Verifizierung abwarten Die Plattform prüft den DNS-Eintrag automatisch im Hintergrund. Sobald die DNS-Propagation abgeschlossen ist, schaltet der Status im Dashboard von **Pending** auf **Verified**. Die Wartezeit liegt typischerweise zwischen 5 Minuten und 24 Stunden, abhängig vom DNS-Provider und der vorher gesetzten TTL. Du kannst den Status zwischendurch manuell aktualisieren über die Schaltfläche **Status neu prüfen**. --- ## Schritt 4: SSL-Zertifikat Nach erfolgreicher Verifizierung wird automatisch ein SSL-Zertifikat über Let's Encrypt ausgestellt und für die Domain installiert. Der Vorgang dauert in der Regel weniger als 5 Minuten. Die Verlängerung läuft danach vollautomatisch alle 60 Tage. Du musst dich um nichts kümmern. Es entstehen keine zusätzlichen Kosten für das Zertifikat. --- ## Schritt 5: Als Primärdomain aktivieren In der Domain-Übersicht steht neben dem verifizierten Eintrag der Schalter **Als Primärdomain festlegen**. Nach Aktivierung passieren drei Dinge: 1. Logins und neu generierte Email-Links zeigen auf die Custom-Domain. 2. Die Standard-Subdomain `mueller-immo.reosa.de` bleibt aktiv und leitet per HTTP-Redirect (301) auf die Custom-Domain um. **Bestehende Links und Lesezeichen funktionieren weiter.** Niemand muss umgewöhnt werden. 3. Email-Templates (Einladungen, Benachrichtigungen) verwenden ab sofort die neue Domain in allen Links. --- ## Was tun, wenn die Verifizierung fehlschlägt? Der häufigste Grund: ein alter A-Record überlagert den neuen CNAME-Eintrag. Diagnose vom Terminal: ``` dig CNAME app.deine-domain.de ``` Die Antwort sollte den im Dashboard angezeigten Zielwert enthalten. Liefert `dig` einen A-Record statt einem CNAME, lösche den A-Record beim DNS-Provider und warte erneut die TTL ab. Weitere häufige Ursachen: - **Tippfehler im CNAME-Ziel:** beim Eintragen verrutschen schnell Punkte oder Buchstaben. - **DNSSEC mit falscher Konfiguration:** sehr selten, aber bei manchen Providern fehlerhaft konfiguriert. - **Cloudflare-Proxy aktiv:** wenn Cloudflare als DNS-Provider verwendet wird, muss der orange Wolken-Proxy für diesen Record **deaktiviert** sein (graue Wolke, "DNS only"). Mit aktivem Proxy schlägt die SSL-Verifizierung fehl. Bleibt der Status nach 24 Stunden auf Pending, kontaktiere den Support mit der genauen Domain und einer Ausgabe des `dig`-Befehls. --- ## Domain wechseln oder entfernen Eine Custom-Domain lässt sich jederzeit über **Einstellungen > Domains** entfernen. Bei Entfernung greift sofort wieder die Standard-Subdomain. Bestehende Sitzungen bleiben aktiv. Vor dem Entfernen empfehlen wir, betroffene Teammitglieder kurz zu informieren.