Eine eigene Domain für Ihr Help Center einrichten

Diese Anleitung führt Sie Schritt für Schritt durch, wie Sie eine Domain, die Ihnen gehört (zum Beispiel hilfe.ihrunternehmen.de), auf Ihr Deskwoot-Help-Center zeigen lassen. Kein technischer Hintergrund nötig, wir erklären jeden Schritt und was im Hintergrund passiert. Gesamtzeit: 5 Minuten Einrichtung, danach 2 bis 10 Minuten Wartezeit. Verfügbar im Enterprise-Tarif.

Was Sie hier in einfachen Worten tun

Im Moment liegt Ihr Help Center unter ihrunternehmen.deskwoot.com. Das ist völlig in Ordnung, aber größere Unternehmen möchten es meist auf einer Subdomain der eigenen Marke haben, etwa hilfe.ihrunternehmen.de oder support.ihrunternehmen.de. Damit das funktioniert, müssen Sie dem globalen Adressbuch des Internets (DNS) mitteilen, dass hilfe.ihrunternehmen.de die Inhalte des Deskwoot-Help-Centers ausliefern soll.

Das machen Sie, indem Sie zwei kleine Einträge bei Ihrem Domain-Registrar hinzufügen (Cloudflare, GoDaddy, Namecheap, Google Domains usw.). Ein Eintrag leitet den Traffic zu uns. Der andere erlaubt uns, automatisch ein kostenloses SSL-Zertifikat zu installieren, damit die Seite mit dem grünen Schloss lädt. Das war's.

Bevor Sie beginnen

Sie müssen Administrator in Ihrem Deskwoot-Konto sein.
Sie müssen im Enterprise-Tarif sein. Niedrigere Tarife sehen dasselbe Panel, aber gesperrt.
Sie benötigen Zugriff auf Ihren DNS-Anbieter. Das ist dort, wo Sie die Domain gekauft haben (oder wohin Sie deren DNS verlegt haben). Häufige: Cloudflare, GoDaddy, Namecheap, Route 53, Google Domains.
Wählen Sie eine Subdomain, nicht die Root-Domain. Subdomains wie hilfe, support oder docs funktionieren. Die Root-Domain (ihrunternehmen.de allein) funktioniert NICHT, warum, erklären wir später.

Schritt 1: Die Domain in Deskwoot eingeben

Öffnen Sie Help Center im Deskwoot-Dashboard.
Klicken Sie im rechten Panel auf den Tab Einstellungen.
Scrollen Sie zum Abschnitt Eigene Domain.
Geben Sie den vollständigen Hostnamen ein, den Sie möchten (z. B. hilfe.acme.de), und klicken Sie auf Registrieren.

Deskwoot reserviert den Hostnamen auf unserer Edge-Schicht und zeigt Ihnen zwei DNS-Einträge, die Sie bei Ihrem DNS-Anbieter hinzufügen. Beide Einträge haben einen Kopieren-Button daneben. Das Status-Badge springt auf "Warten auf DNS".

Schritt 2: Die zwei DNS-Einträge bei Ihrem Anbieter hinzufügen

Sie fügen zwei Einträge hinzu. Beide sind CNAME-Einträge. Ein CNAME ist einfach ein Eintrag im DNS nach dem Muster "dieser Name zeigt auf jenen anderen Namen". Die meisten Anbieter haben ein einfaches Formular: Typ wählen (CNAME), einen Namen eingeben, einen Wert eingeben, speichern.

Eintrag 1: der Haupt-CNAME (leitet Ihre Besucher zu Deskwoot)

Typ: CNAME
Name / Host: der Subdomain-Teil Ihres Hostnamens. Wenn Sie hilfe.acme.de registriert haben, ist das hilfe. Die meisten Anbieter hängen den Rest automatisch an, manche wollen aber den vollständigen Hostnamen (hilfe.acme.de). Beides funktioniert je nach Anbieter.
Wert / Ziel / Zeigt auf: kopieren Sie dies aus dem Deskwoot-Dashboard. Es sieht aus wie xxxxx.up.railway.app.
TTL: auf auto / Standard lassen (meist 300 Sekunden = 5 Minuten).
Proxy / orange Wolke bei Cloudflare: AUS (nur DNS, siehe Cloudflare-spezifische Hinweise unten).

Eintrag 2: der ACME-Challenge-CNAME (lässt uns das SSL-Zertifikat ausstellen)

Typ: CNAME (manche Anbieter akzeptieren auch TXT, CNAME wird bevorzugt).
Name / Host: _acme-challenge.hilfe (oder _acme-challenge.hilfe.acme.de je nach Anbieter, den genauen Wert finden Sie im Dashboard).
Wert / Ziel: der Wert, den Deskwoot neben der ACME-Zeile anzeigt. Sieht aus wie xxxxx.dns.railwaydns.net.
TTL: auto / Standard.
Proxy / orange Wolke bei Cloudflare: AUS.

Beide Einträge sind erforderlich. Wenn Sie nur den ersten hinzufügen, lädt die Seite nicht über HTTPS, weil das SSL-Zertifikat ohne den ACME-Challenge-Eintrag nicht ausgestellt werden kann.

Schritt 3: Warten, dann auf "Jetzt prüfen" klicken

DNS-Änderungen brauchen Zeit, um sich weltweit zu verbreiten. Typische Verbreitung:

Cloudflare: 1 bis 2 Minuten.
Namecheap / GoDaddy / Google Domains: 5 bis 15 Minuten.
Alte oder langsame Anbieter / hohe TTL: bis zu 24 Stunden (selten).

Sobald ein paar Minuten vergangen sind, gehen Sie zurück ins Deskwoot-Dashboard und klicken Sie im Panel Eigene Domain auf Jetzt prüfen. Das Status-Badge aktualisiert sich:

Warten auf DNS: Ihre CNAME-Einträge sind von dort, wo Deskwoot prüft, noch nicht sichtbar. Warten Sie noch ein bis zwei Minuten.
SSL-Zertifikat wird ausgestellt: DNS ist in Ordnung, Let's Encrypt erzeugt Ihr Zertifikat. Dauert meist weniger als eine Minute.
Live: Ihre Domain liefert Traffic mit HTTPS aus. Sie sind fertig.

Der Button Jetzt prüfen hat eine Abklingzeit von 10 Sekunden, damit Sie ihn nicht versehentlich überstrapazieren. Die DNS-Verbreitung wird nicht schneller, nur weil Sie öfter klicken.

Was im Hintergrund passiert

Sie müssen das nicht wissen, damit es funktioniert, aber für die Neugierigen:

Wenn Sie auf Registrieren klicken, teilt Deskwoot Railway (unserer Hosting-Plattform) mit, Ihren Hostnamen in deren Routing-Tabelle aufzunehmen.
Railway erzeugt ein Paar von DNS-Zielen: den Haupt-CNAME zum Leiten des Traffics und einen speziellen ACME-Challenge-CNAME, der Let's Encrypt überprüfen lässt, dass Sie die Domain kontrollieren.
Sie fügen beide Einträge bei Ihrem DNS-Anbieter hinzu.
Der Hintergrund-DNS-Watcher von Railway fragt die Einträge alle paar Sekunden ab.
Sobald beide Einträge weltweit sichtbar sind, fragt Railway automatisch über das ACME-Protokoll bei Let's Encrypt ein kostenloses SSL-Zertifikat an.
Let's Encrypt validiert die Challenge (es bestätigt, dass Ihr _acme-challenge.<domain>-CNAME dorthin zeigt, wo wir es angegeben haben), stellt das Zertifikat aus, und Railway installiert es auf der Edge.
Ihre Domain liefert nun HTTPS-Traffic aus. Das Zertifikat erneuert sich alle 60 bis 90 Tage automatisch; Sie müssen es nie anfassen.

Kosten: 0 $. Let's-Encrypt-Zertifikate sind kostenlos, Railway stellt sie für uns ohne Aufpreis bereit, und Deskwoot enthält eigene Domains im Enterprise-Tarif ohne Gebühr pro Domain.

Anbieterspezifische Hinweise

Cloudflare

Der häufigste Fehler: die orange Wolke (Proxy) AN zu lassen. Der Proxy von Cloudflare beendet die Anfrage, bevor sie Railway erreicht, was sowohl den Haupt-CNAME als auch die ACME-Challenge bricht. Klicken Sie die orange Wolke an, um sie auf eine graue Wolke (nur DNS) umzuschalten, bei BEIDEN Einträgen.
Wenn Sie das Universal SSL von Cloudflare nutzen, warnt es eventuell vor einem Konflikt. Ignorieren Sie die Warnung, das Zertifikat, das wir auf der Edge von Deskwoot installieren, ist das, was Ihre Besucher sehen.
Die Verbreitung bei Cloudflare ist schnell: meist 60 bis 90 Sekunden.

GoDaddy

Verwenden Sie auf der Seite DNS-Verwaltung den Button "Hinzufügen", dann CNAME.
Für den ACME-Eintrag akzeptiert das Host-Feld das vollständige Format _acme-challenge.hilfe.
GoDaddy entfernt nachgestellte Punkte aus dem Wert-Feld, das ist zu erwarten.

Namecheap

Gehen Sie zu Domain List, dann Manage, dann Advanced DNS.
Add New Record, dann CNAME Record.
Für das Host-Feld hängt "hilfe" automatisch .ihrunternehmen.de an.

Google Domains / Squarespace Domains

Google hat die meisten Domain-Kunden 2024 zu Squarespace migriert. Beide Plattformen haben denselben CNAME-Ablauf.
Suchen Sie nach "DNS", dann "Manage custom records", dann Add, dann CNAME.

AWS Route 53

Öffnen Sie die Hosted Zone für Ihre Domain, dann Create record, dann CNAME.
Verwenden Sie den vollständigen Hostnamen im Name-Feld. Route 53 hängt nicht automatisch an.

Warum die Root-Domain nicht funktioniert

Sie können ihrunternehmen.de nicht allein (ohne Subdomain) verwenden, weil der DNS-Standard keine CNAME-Einträge an der "Wurzel" einer Domain erlaubt. Das nennt man die "Apex"- oder "nackte" Domain.

Wenn Sie das Help Center wirklich auf Ihrer Root-Domain haben möchten, gibt es zwei Möglichkeiten:

Verwenden Sie eine Subdomain (empfohlen): hilfe.ihrunternehmen.de, support.ihrunternehmen.de, docs.ihrunternehmen.de.
Verwenden Sie die "ALIAS"- oder "ANAME"-Funktion Ihres DNS-Anbieters, falls er sie unterstützt (CNAME-Flattening bei Cloudflare, Alias-Einträge bei Route 53, ALIAS bei DNSimple). Das sind anbieterspezifische Hilfslösungen und werden nicht offiziell unterstützt.

Fehlerbehebung

Hängt bei "Warten auf DNS"

Haben Sie BEIDE Einträge hinzugefügt? Einer allein funktioniert nicht. Sie brauchen den Haupt-CNAME und den _acme-challenge-CNAME.
Haben Sie den genauen Wert aus Deskwoot kopiert? Schon ein kleiner Tippfehler (ein zusätzliches Zeichen, ein fehlender Punkt) bricht die Auflösung.
Haben Sie den Cloudflare-Proxy ausgeschaltet? Orange Wolke bedeutet "proxied" und bricht die Challenge. Graue Wolke ist richtig.
Gibt es einen widersprüchlichen A-Eintrag? Wenn hilfe.ihrunternehmen.de zuvor mit einem A-Eintrag woandershin zeigte, löschen Sie ihn. Ein CNAME kann nicht mit anderen Einträgen auf demselben Namen koexistieren.
Prüfen Sie die Einträge mit einem externen Werkzeug: führen Sie dig CNAME hilfe.ihrunternehmen.de in einem Terminal aus oder nutzen Sie ein webbasiertes DNS-Lookup-Werkzeug. Sie sollten das Railway-Ziel sehen. Wenn nicht, ist der Eintrag noch nicht verbreitet.

Hängt länger als 2 Minuten bei "SSL-Zertifikat wird ausgestellt"

Häufigste Ursache: der _acme-challenge-CNAME fehlt, zeigt auf das falsche Ziel oder ist ebenfalls über Cloudflare geproxied.
Prüfen Sie ihn gezielt: dig CNAME _acme-challenge.hilfe.ihrunternehmen.de sollte das railwaydns.net-Ziel zurückgeben.
Manche DNS-Anbieter entfernen das Unterstrich-Präfix oder wandeln es um. Wenn Ihr Anbieter keine Namen akzeptiert, die mit _ beginnen, wechseln Sie für diese Domain den Anbieter oder kontaktieren Sie uns, wir helfen, eine Lösung zu finden.

Die Domain zeigt "Live", aber die Seite zeigt eine Sicherheitswarnung im Browser

Laden Sie die Seite hart neu (Cmd+Shift+R auf dem Mac, Ctrl+Shift+R unter Windows). Browser cachen SSL-Zertifikate aggressiv.
Warten Sie 1 bis 2 Minuten. Manchmal ist das Zertifikat ausgestellt, aber noch nicht auf jedem Edge-Knoten installiert.
Probieren Sie ein Inkognito- bzw. privates Fenster.

Ich möchte eine andere Domain verwenden, wie ändere ich sie?

Klicken Sie im Panel Eigene Domain auf Entfernen. Das deregistriert den Hostnamen bei Railway und löscht die DNS-Werte aus Deskwoot.
Löschen Sie die alten CNAME-Einträge bei Ihrem DNS-Anbieter (optional, aber ordentlicher).
Registrieren Sie den neuen Hostnamen und fügen Sie dessen DNS-Einträge hinzu.

Häufig gestellte Fragen

Kostet die eigene Domain oder das SSL etwas?

Nein. Beides ist im Enterprise-Tarif ohne Aufpreis enthalten. Das SSL-Zertifikat wird von Let's Encrypt ausgestellt (kostenlos), und Railway installiert es für uns (für unseren Anwendungsfall kostenlos). Sie zahlen nur Ihrem DNS-Anbieter für die Domain-Registrierung selbst, was mit Deskwoot nichts zu tun hat.

Was ist mit Erneuerungen?

Let's-Encrypt-Zertifikate gelten 90 Tage. Railway erneuert sie automatisch, bevor sie ablaufen, in der Regel alle 60 Tage. Sie müssen das nie anfassen.

Kann ich mehrere eigene Domains für dasselbe Help Center verwenden?

Heute nicht, eine eigene Domain pro Help-Center-Portal. Wenn Sie mehrere gebrandete Portale möchten, erstellen Sie ein eigenes Portal pro Marke und registrieren Sie für jedes eine eigene Domain.

Hört die deskwoot.com-URL auf zu funktionieren, wenn ich eine eigene Domain hinzufüge?

Nein. Beide URLs liefern parallel dasselbe Help Center aus. Sie können wählen, welche Sie mit Kunden teilen; die andere funktioniert als Rückfalloption weiter.

Kann ich das Help Center weiter anpassen, nachdem es auf einer eigenen Domain live ist?

Ja, alles in den Help-Center-Einstellungen (Kategorien, Artikel, Design, Branding, White-Label) funktioniert genau gleich weiter. Die eigene Domain ändert nur, von wo die Seite ausgeliefert wird.

Was, wenn meine Domain abläuft oder ich sie zu einem anderen Anbieter verlege?

Wenn Ihre Domain abläuft oder die DNS-Einträge gelöscht werden, sehen Besucher einen "Diese Seite ist nicht erreichbar"-Fehler in ihrem Browser. Die <slug>.deskwoot.com-URL funktioniert parallel weiter. Fügen Sie die CNAME-Einträge erneut hinzu (oder verlegen Sie das DNS zurück), um die eigene Domain wiederherzustellen.