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.