Eine eigene Domain für dein Hilfecenter einrichten

Diese Anleitung zeigt dir Schritt für Schritt, wie du eine Domain, die dir gehört (zum Beispiel hilfe.deinunternehmen.de), auf dein Deskwoot-Hilfecenter zeigen lässt. Du brauchst kein technisches Vorwissen, wir erklären jeden Schritt und was dabei im Hintergrund passiert. Gesamtzeit: 5 Minuten Einrichtung, danach 2 bis 10 Minuten Wartezeit. Verfügbar im Enterprise-Tarif.

Was du hier in einfachen Worten machst

Im Moment liegt dein Hilfecenter unter deinunternehmen.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.deinunternehmen.de oder support.deinunternehmen.de. Dafür teilst du dem Adressbuch des Internets (DNS) mit, dass hilfe.deinunternehmen.de die Inhalte deines Deskwoot-Hilfecenters ausliefern soll.

Dazu trägst du bei deinem Domain-Anbieter (Cloudflare, GoDaddy, Namecheap, Google Domains usw.) die DNS-Einträge ein, die Deskwoot dir anzeigt. Für eine Subdomain ist das meist ein einziger CNAME, der den Verkehr zu uns leitet. Manchmal verlangt Deskwoot zusätzlich einen TXT-Eintrag, der bestätigt, dass die Domain dir gehört. Sobald die Einträge stehen, wird automatisch ein kostenloses SSL-Zertifikat installiert, damit die Seite mit dem Schloss-Symbol lädt. Das war's.

Bevor du anfängst

• Du musst Administrator in deinem Deskwoot-Konto sein.
• Du brauchst den Enterprise-Tarif. In kleineren Tarifen siehst du denselben Bereich, aber gesperrt.
• Du brauchst Zugriff auf deinen DNS-Anbieter. Das ist dort, wo du die Domain gekauft hast (oder wohin du ihr DNS umgezogen hast). Häufige Anbieter: Cloudflare, GoDaddy, Namecheap, Route 53, Google Domains.
• Nimm wenn möglich eine Subdomain. Subdomains wie hilfe, support oder docs brauchen meist nur einen CNAME. Eine Root-Domain (deinunternehmen.de allein) braucht andere Einträge, mehr dazu weiter unten.

Schritt 1: Die Domain in Deskwoot eingeben

1. Öffne Hilfecenter im Deskwoot-Dashboard.
2. Klicke rechts auf den Tab Einstellungen.
3. Scrolle zum Abschnitt Eigene Domain.
4. Gib den vollständigen Hostnamen ein, den du möchtest (z. B. hilfe.acme.de), und klicke auf Registrieren.

Deskwoot reserviert den Hostnamen auf unserer Edge und zeigt dir die DNS-Einträge, die du bei deinem DNS-Anbieter hinzufügen musst. Bei jedem Eintrag gibt es Buttons, um Host und Wert zu kopieren. Der Status springt auf „Warte auf DNS“.

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

Füge jeden Eintrag hinzu, den das Dashboard auflistet, genau so wie angezeigt. Für eine Subdomain ist das meist ein CNAME-Eintrag. Ein CNAME ist einfach ein DNS-Eintrag nach dem Muster „dieser Name zeigt auf jenen anderen Namen“. Die meisten Anbieter haben dafür ein einfaches Formular: Typ wählen (CNAME), Namen eingeben, Wert eingeben, speichern.

Der CNAME (leitet deine Besucher zu Deskwoot)

• Typ: CNAME
• Name / Host: der Subdomain-Teil deines Hostnamens. Wenn du hilfe.acme.de registriert hast, ist das hilfe. Die meisten Anbieter hängen den Rest automatisch an, manche wollen aber den vollständigen Hostnamen (hilfe.acme.de). Je nach Anbieter funktioniert beides.
• Wert / Ziel / Zeigt auf: kopiere ihn aus dem Deskwoot-Dashboard. Er sieht aus wie xxxxx.up.railway.app.
• TTL: auf Auto oder Standard lassen (meist 300 Sekunden, also 5 Minuten).
• Proxy / orange Wolke bei Cloudflare: AUS (nur DNS, siehe die Hinweise zu Cloudflare unten).

Ein TXT-Eintrag, falls das Dashboard einen anzeigt (bestätigt, dass dir die Domain gehört)

• Typ: TXT.
• Name / Host: der Host, den das Dashboard anzeigt, zum Beispiel _railway-verify.hilfe.acme.de (er kann auch mit _acme-challenge beginnen). Viele Anbieter wollen nur den Teil vor deiner Domain (_railway-verify.hilfe) und ergänzen den Rest selbst.
• Wert: der Wert, den Deskwoot in dieser Zeile anzeigt.
• TTL: Auto oder Standard.

Jeder Eintrag in der Liste ist nötig. Wenn das Dashboard einen TXT-Eintrag anzeigt und du ihn auslässt, kann das SSL-Zertifikat nicht ausgestellt werden, und die Seite lädt nicht über HTTPS. Die Liste kann sich während der Einrichtung ändern (ein Eintrag für das Zertifikat kann erst erscheinen, wenn die Ausstellung beginnt). Klicke also später noch einmal auf Jetzt prüfen und füge jeden neuen Eintrag hinzu, der auftaucht.

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

DNS-Änderungen brauchen Zeit, bis sie sich weltweit verbreitet haben. Typische Dauer:

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

Wenn ein paar Minuten vergangen sind, geh zurück ins Deskwoot-Dashboard und klicke im Abschnitt Eigene Domain auf Jetzt prüfen. Der Status ändert sich:

• Warte auf DNS: Deine DNS-Einträge sind von dort, wo Deskwoot prüft, noch nicht sichtbar. Warte noch ein bis zwei Minuten.
• SSL Zertifikat wird ausgestellt: DNS passt, Let's Encrypt erstellt dein Zertifikat. Das dauert meist weniger als eine Minute.
• Live: Deine Domain ist über HTTPS erreichbar. Fertig.

Nach jedem Klick auf Jetzt prüfen musst du 10 Sekunden warten, damit du den Button nicht aus Versehen dauernd drückst. Die DNS-Verbreitung wird durch häufigeres Klicken nicht schneller.

Was im Hintergrund passiert

Für die Einrichtung musst du das nicht wissen, aber für Neugierige:

1. Wenn du auf Registrieren klickst, bittet Deskwoot Railway (unsere Hosting-Plattform), deinen Hostnamen in seine Routing-Tabelle aufzunehmen.
2. Railway legt fest, welche DNS-Einträge deine Domain braucht: einen Eintrag, der den Verkehr leitet (einen CNAME für eine Subdomain, einen A- oder ALIAS-Eintrag für eine Root-Domain), und bei Bedarf einen TXT-Eintrag, der beweist, dass du die Domain kontrollierst, damit Let's Encrypt ein Zertifikat ausstellen kann.
3. Du trägst diese Einträge bei deinem DNS-Anbieter ein.
4. Railway prüft die Einträge im Hintergrund alle paar Sekunden.
5. Sobald die Einträge weltweit sichtbar sind, fordert Railway über das ACME-Protokoll automatisch ein kostenloses SSL-Zertifikat bei Let's Encrypt an.
6. Let's Encrypt prüft, dass du die Domain kontrollierst, stellt das Zertifikat aus, und Railway installiert es auf der Edge.
7. Deine Domain ist jetzt über HTTPS erreichbar. Das Zertifikat erneuert sich alle 60 bis 90 Tage automatisch, du musst dich nie darum kümmern.

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.

Hinweise zu einzelnen Anbietern

Cloudflare

• Der häufigste Fehler: die orange Wolke (Proxy) eingeschaltet lassen. Der Proxy von Cloudflare fängt die Anfrage ab, bevor sie Railway erreicht. Dadurch können die Prüfung der Domain und das SSL-Zertifikat scheitern. Klicke auf die orange Wolke, damit sie grau wird (nur DNS), und zwar bei JEDEM Eintrag.
• Wenn du Universal SSL von Cloudflare nutzt, warnt es vielleicht vor einem Konflikt. Ignoriere die Warnung: Deine Besucher sehen das Zertifikat, das wir auf der Edge von Deskwoot installieren.
• Bei Cloudflare geht die Verbreitung schnell, meist in 60 bis 90 Sekunden.

GoDaddy

• Nutze auf der Seite DNS-Verwaltung den Button „Hinzufügen“ und dann CNAME.
• Bei einem Eintrag, dessen Name mit einem Unterstrich beginnt (etwa _railway-verify.hilfe), gib den Host genau so ein, wie das Dashboard ihn anzeigt.
• GoDaddy entfernt Punkte am Ende des Wert-Felds, das ist normal.

Namecheap

• Geh zu Domain List, dann Manage, dann Advanced DNS.
• Add New Record, dann CNAME Record.
• Im Host-Feld hängt Namecheap an „hilfe“ automatisch .deinunternehmen.de an.

Google Domains / Squarespace Domains

• Google hat die meisten Domain-Kunden 2024 zu Squarespace umgezogen. Auf beiden Plattformen läuft der CNAME gleich.
• Such nach „DNS“, dann „Manage custom records“, dann Add, dann CNAME.

AWS Route 53

• Öffne die Hosted Zone deiner Domain, dann Create record, dann CNAME.
• Gib im Feld Name den vollständigen Hostnamen ein. Route 53 hängt nichts automatisch an.

Und die Root-Domain?

Der DNS-Standard erlaubt keine CNAME-Einträge an der „Wurzel“ einer Domain (deinunternehmen.de allein, auch „Apex“ oder „nackte“ Domain genannt). Deskwoot nimmt eine Root-Domain trotzdem an: Das Dashboard zeigt dir dann statt eines CNAME einen A- oder ALIAS-Eintrag plus einen TXT-Eintrag.

Du hast zwei Möglichkeiten:

• Nimm eine Subdomain (empfohlen): hilfe.deinunternehmen.de, support.deinunternehmen.de, docs.deinunternehmen.de.
• Nimm die Root-Domain und trag genau die Einträge ein, die das Dashboard anzeigt. Für einen ALIAS-Eintrag braucht dein DNS-Anbieter eine „ALIAS“- oder „ANAME“-Funktion (CNAME-Flattening bei Cloudflare, Alias-Einträge bei Route 53, ALIAS bei DNSimple).

Fehlerbehebung

Hängt bei „Warte auf DNS“

1. Hast du JEDEN Eintrag hinzugefügt? Du brauchst jeden Eintrag, den das Dashboard auflistet, auch einen TXT-Eintrag, falls einer angezeigt wird.
2. Hast du den Wert genau aus Deskwoot kopiert? Schon ein kleiner Tippfehler (ein Zeichen zu viel, ein fehlender Punkt) verhindert die Auflösung.
3. Hast du den Cloudflare-Proxy ausgeschaltet? Die orange Wolke bedeutet „über den Proxy“ und kann die Prüfung verhindern. Richtig ist die graue Wolke.
4. Gibt es einen störenden A-Eintrag? Wenn hilfe.deinunternehmen.de vorher per A-Eintrag woandershin gezeigt hat, lösche ihn. Ein CNAME kann nicht zusammen mit anderen Einträgen auf demselben Namen stehen.
5. Prüf die Einträge von außen: Führe dig CNAME hilfe.deinunternehmen.de in einem Terminal aus oder nutze eine DNS-Abfrage im Web. Du solltest das Railway-Ziel sehen. Wenn nicht, hat sich der Eintrag noch nicht verbreitet.

Hängt länger als 2 Minuten bei „SSL Zertifikat wird ausgestellt“

1. Häufigste Ursache: Ein Eintrag aus der Liste im Dashboard (oft ein TXT-Eintrag) fehlt, hat den falschen Wert oder läuft über den Cloudflare-Proxy. Klicke auf Jetzt prüfen: Wenn ein neuer Eintrag in der Liste aufgetaucht ist, füge ihn ebenfalls hinzu.
2. Prüf ihn gezielt mit dem Host aus dem Dashboard: dig TXT _railway-verify.hilfe.deinunternehmen.de sollte den Wert zurückgeben, den Deskwoot anzeigt.
3. Manche DNS-Anbieter entfernen den Unterstrich am Anfang oder wandeln ihn um. Wenn dein Anbieter keine Namen akzeptiert, die mit _ beginnen, wechsle für diese Domain den Anbieter oder melde dich bei uns, dann suchen wir gemeinsam eine Lösung.

Die Domain zeigt „Live“, aber der Browser zeigt eine Sicherheitswarnung

1. Lade die Seite ohne Cache neu (Cmd+Shift+R auf dem Mac, Ctrl+Shift+R unter Windows). Browser speichern SSL-Zertifikate hartnäckig zwischen.
2. Warte 1 bis 2 Minuten. Manchmal ist das Zertifikat ausgestellt, aber noch nicht auf jedem Edge-Knoten installiert.
3. Probier ein Inkognito- oder privates Fenster.

Ich möchte eine andere Domain nutzen. Wie ändere ich sie?

1. Klicke im Abschnitt Eigene Domain auf Entfernen. Damit wird der Hostname bei Railway abgemeldet, und die DNS-Werte verschwinden aus Deskwoot.
2. Lösche die alten DNS-Einträge bei deinem DNS-Anbieter (optional, aber aufgeräumter).
3. Registriere den neuen Hostnamen und füge seine DNS-Einträge hinzu.

Häufige Fragen