Eigene Domain mit einer App verbinden

Jede App bekommt von uns eine Adresse, aber meistens soll sie unter deiner eigenen Domain erreichbar sein. Diese Anleitung zeigt, wie du eine Domain oder Subdomain mit einer App verbindest, welchen DNS-Record du anlegen musst und wie du prüfst, ob alles geklappt hat. HTTPS wird für dich eingerichtet, ohne Aufpreis.

Was du brauchst

Eine App, die im Panel läuft.
Eine Domain, die du verwaltest, mit Zugriff auf die DNS-Einstellungen. Das kann eine bei uns registrierte Domain sein oder eine von einem anderen Anbieter.

Domain zur App hinzufügen

Melde dich im Panel an, öffne Apps und klicke auf deine App.
Suche die Karte Eigene Domains und klicke auf Domain hinzufügen.
Trage unter Hostname die gewünschte Adresse ein. Nimm eine Subdomain wie blog.example.com oder die Domain selbst, etwa example.com.
Klicke auf Hinzufügen.

Das Panel zeigt jetzt den DNS-Record, den deine Domain braucht. Die Domain erscheint in der Liste mit dem Status ausstehend, bis dieser Record vorhanden ist.

DNS-Record anlegen

Es gibt zwei Wege, deine Domain auf die App zeigen zu lassen.

Variante 1: ein CNAME-Record (empfohlen)

Lege für deinen Hostnamen einen CNAME-Record an, der auf das Ziel zeigt, das das Panel anzeigt. Das Ziel ist die eigene Adresse der App. Damit belegt dieser Record zugleich, dass die Domain für diese App gedacht ist. Mehr ist nicht nötig.

Variante 2: ein A-Record

Manche DNS-Anbieter erlauben keinen CNAME auf der Domain selbst (example.com ohne etwas davor). In diesem Fall:

Lege einen A-Record an, der auf die IP-Adresse zeigt, die das Panel anzeigt.
Lege zusätzlich den TXT-Record an, den das Panel anzeigt. Sein Name beginnt mit _panel-challenge., gefolgt von deinem Hostnamen, und sein Wert ist ein Code, der zu deiner App gehört.

Der TXT-Record ist bei einem A-Record Pflicht. Viele Kunden teilen sich dieselbe IP-Adresse, und über den TXT-Record erkennen wir, dass die Domain wirklich dir gehört.

Wenn dein DNS bei uns liegt

Wird die DNS-Zone der Domain im Panel verwaltet, musst du nichts kopieren. Klicke auf DNS automatisch einrichten und das Panel legt die Records für dich an. Gibt es unter diesem Namen schon einen Record, wirst du vor dem Ersetzen um Bestätigung gebeten.

Auf die Prüfung warten

Wir prüfen den Record automatisch alle paar Minuten. Um sofort zu prüfen, klicke in der Liste auf das Aktualisieren-Symbol neben der Domain.

Sobald der Record gefunden wird, wechselt der Status auf verifiziert.
Danach wird HTTPS automatisch eingerichtet. Das dauert meist unter einer Minute, höchstens etwa drei Minuten.
Deine erste geprüfte Domain wird zur Hauptadresse der App. Die App startet dafür kurz neu.

DNS-Änderungen wirken nicht sofort. Wenn du den Record gerade erst angelegt hast, warte ein paar Minuten, bevor du es erneut versuchst.

Mit Cloudflare

Läuft deine Domain über den Cloudflare-Proxy (die orange Wolke), funktioniert die Prüfung trotzdem, du brauchst aber zusätzlich den TXT-Record aus Variante 2. Stelle den SSL/TLS-Modus bei Cloudflare auf Full oder Full (strict), damit HTTPS bis zu deiner App durchgehend funktioniert.

Wenn die Prüfung fehlschlägt

Die Liste zeigt den Grund unter der Domain. Die häufigsten Ursachen:

Der Record zeigt woanders hin. Vergleiche Ziel oder IP-Adresse mit der Anzeige im Panel. Vielleicht existiert noch ein alter Record mit demselben Namen.
Die Domain wird noch nicht aufgelöst. Der Record ist neu und hat sich noch nicht verbreitet, oder er wurde unter dem falschen Namen angelegt.
Der TXT-Record fehlt. Bei einem A-Record oder einer Domain hinter einem Proxy muss der TXT-Record _panel-challenge existieren und genau den angezeigten Wert enthalten.

Domain entfernen

Öffne die Karte Eigene Domains, klicke auf das Entfernen-Symbol neben der Domain und bestätige mit Entfernen. Die Domain liefert deine App dann nicht mehr aus. Denke daran, auch den DNS-Record bei deinem Anbieter zu löschen.

Du brauchst noch eine Domain? Siehe Domain registrieren.