Doku / Custom Domain

Custom Domain + DNS einrichten

Deine eigene Domain (z.B. erp.deinefirma.at) auf deine Odoo-Instanz zeigen lassen - mit automatischem TLS-Zertifikat.

Kurz gesagt: Jede Instanz ist ab Start unter einer erpdock-Standard-Domain erreichbar. Für eine eigene Domain setzt du genau einen DNS-Record bei deinem Domain-Anbieter, meldest uns die Domain, und das TLS-Zertifikat wird automatisch ausgestellt, sobald der DNS-Eintrag greift.

Deine Standard-Domain

Jede Instanz bekommt bei der Bereitstellung eine feste erpdock-Domain nach diesem Muster:

Instanz-Typ	Standard-Domain
Produktion	deinslug.erpdock.eu
Staging	staging.deinslug.erpdock.eu
Dev	dev.deinslug.erpdock.eu

Die erste Staging- bzw. Dev-Umgebung behält ihren Namen dauerhaft; weitere heißen staging2., staging3. usw. Diese Domain funktioniert sofort, ganz ohne eigene DNS-Konfiguration.

Schritt 1: DNS-Record setzen

Welchen Record du setzt, hängt davon ab, ob du eine Subdomain oder deine Root-Domain verwendest:

Dein Ziel	Record-Typ	Wert
Subdomain, z.B. erp.deinefirma.at	CNAME	deinslug.erpdock.eu
Root-/Apex-Domain, z.B. deinefirma.at	A	IP deiner Instanz (nennen wir dir)

Empfehlung: Nutze eine Subdomain per CNAME. Der CNAME zeigt auf deine erpdock-Domain, nicht auf eine feste IP - zieht deine Instanz später auf eine andere VM um, musst du nichts ändern. Ein A-Record auf die Root-Domain ist an die IP gebunden.

TTL und IPv6

TTL: Setz 120 Sekunden. Kurze TTL heißt, dass Änderungen schnell greifen.
Nur A-/CNAME-Records: Wir arbeiten aktuell ohne AAAA/IPv6-Records. Ein reiner IPv4-A-Record bzw. CNAME genügt.
Kein Wildcard nötig: Du setzt einen Record pro Domain, kein *-Wildcard.

Schritt 2: Domain anmelden

Melde uns die Domain, die du verbinden willst - über das Portal oder an service@erpdock.eu. Deine Instanz läuft in der Zwischenzeit ungestört unter der Standard-Domain weiter; das Hinzufügen einer Domain blockiert nichts.

Schritt 3: Zertifikat kommt automatisch

Das TLS-Zertifikat holen wir per Let's Encrypt über die HTTP-01-Challenge - ein Zertifikat pro Domain. Wichtig ist die Reihenfolge:

Du setzt den DNS-Record (Schritt 1).
Wir prüfen, ob die Domain schon korrekt auf deine Instanz zeigt (DNS-Check).
Erst wenn der DNS-Check grün ist, wird das Zertifikat ausgestellt und automatisch erneuert.

Zeigt der Record noch nicht richtig, wird kein Zertifikat auf Verdacht erzeugt - der Versuch wird wiederholt, sobald DNS steht. Plan deshalb etwas Vorlauf ein: DNS-Änderungen brauchen je nach Anbieter ein paar Minuten bis zur weltweiten Sichtbarkeit.

Häufige Fragen

Muss ich ein Wildcard-Zertifikat oder einen Wildcard-Record anlegen?

Nein. Pro Domain gibt es genau einen Record und ein eigenes Zertifikat über die HTTP-01-Challenge. Wildcards sind nicht nötig.

Warum CNAME statt A-Record?

Ein CNAME auf deine erpdock-Domain überlebt einen späteren Umzug deiner Instanz auf eine andere VM, ohne dass du im DNS etwas anpassen musst. Ein A-Record ist an eine feste IP gebunden. Für die Root-/Apex-Domain, die technisch keinen CNAME erlaubt, nutzt du den A-Record auf die IP deiner Instanz.

Bleibt meine Standard-Domain erreichbar?

Ja. Die erpdock-Standard-Domain deiner Instanz bleibt bestehen. Die Custom Domain kommt zusätzlich dazu.

Nächster Schritt: Backups & Restore einrichten oder zurück zur Doku-Übersicht. Fragen zum Umzug einer bestehenden Domain? Erstgespräch buchen.