Zum Inhalt springen

Dokumentation / Domains

Domain hinzufügen

Deinen eigenen Domainnamen auf einen Odoo-Dienst verweisen.

Folge diesen Schritten, um einem deiner Odoo-Dienste eine eigene Domain zuzuweisen.

Schritt-für-Schritt-Anleitung #

1. DNS konfigurieren #

Erstelle bei deinem Domain-Registrar oder DNS-Anbieter einen DNS-Eintrag, der auf deinen Server zeigt:

  • Typ: A-Eintrag
  • Name: Die gewünschte Subdomain (z.B. erp für erp.deineFirma.de)
  • Wert: Die IP-Adresse des Servers, auf dem dein Odoo-Dienst läuft

DNS-Änderungen können bis zu 24 Stunden dauern, werden aber normalerweise innerhalb weniger Minuten wirksam.

2. Hostnamen in calmo.cloud hinzufügen #

  1. Navigiere zu deinem Odoo-Dienst
  2. Klicke auf den Hostnamen-Tab
  3. Klicke auf Hostnamen hinzufügen
  4. Gib den vollständigen Domainnamen ein (z.B. erp.deineFirma.de)

3. Verifizieren und aktivieren #

calmo.cloud konfiguriert den Reverse-Proxy, um den Verkehr von deiner Domain zum Dienst zu leiten. Ein SSL-Zertifikat wird automatisch bereitgestellt.

Deine Odoo-Instanz ist jetzt unter deiner eigenen Domain mit aktiviertem HTTPS erreichbar.

DNS automatisch einrichten #

Die automatische DNS-Einrichtung ist im Early Access und wird Team für Team freigeschaltet. Melde dich bei uns, wenn du sie ausprobieren möchtest.

Manche DNS-Anbieter unterstützen Domain Connect, sodass calmo.cloud den DNS-Eintrag für dich einrichten kann. Unterstützt der Anbieter deiner Domain das, zeigt der Hostname in seinem Abschnitt DNS Records den Button Auto-configure DNS und im Hostnamen-Tab neben der DNS-Prüfung Auto-configure. Klicke darauf, melde dich bei deinem Anbieter an und bestätige. Der Anbieter legt dann den Eintrag an, der auf deinen Server zeigt. Erscheint der Button nicht, richte den Eintrag wie oben beschrieben von Hand ein.

Wildcard-Domains und DNS-Zertifikate #

Um jede Subdomain der ersten Ebene auszuliefern, etwa shop.example.com und customer.example.com, füge *.example.com als Hostnamen hinzu. Füge example.com separat hinzu, wenn du auch die Root-Domain ausliefern möchtest. Ein Wildcard deckt keine verschachtelten Namen wie shop.customer.example.com ab.

Wildcard-Zertifikate benötigen einen DNS-Zertifikat-Resolver:

  1. Öffne die Konfiguration des Hosting-Servers und wähle den Tab Traefik.
  2. Füge unter DNS certificate resolvers einen Resolver hinzu, mit einem Namen, dem Anbieter IONOS und deinem IONOS-API-Schlüssel im Format prefix.secret. DNS propagation wait legt fest, wie lange der Proxy auf das Erscheinen des Validierungseintrags wartet, bevor er das Zertifikat anfordert; die Voreinstellung von 60 Sekunden passt in den meisten Fällen. Speichere die Konfiguration, um den Proxy zu aktualisieren.
  3. Lass einen Wildcard-A-Eintrag (*) auf die IP-Adresse des Servers zeigen.
  4. Füge *.example.com im Hostnamen-Tab des Dienstes hinzu und wähle unter Certificate validation deinen Resolver.

calmo.cloud prüft das Wildcard-DNS mit einer frischen Subdomain, bevor es das Routing aktiviert. Ein genauer Hostname, der auf demselben Server einem anderen Dienst zugewiesen ist, etwa test.example.com, hat Vorrang vor dem Wildcard, sobald sein DNS verifiziert ist. Normale Anfragen, WebSockets und Sicherheitsschutz folgen demselben Routing.

Die DNS-Validierung kannst du auch für einen gewöhnlichen Hostnamen wählen. Andere Domains können bei Automatic (TLS challenge) bleiben, auch wenn ihr DNS bei einem anderen Anbieter gehostet wird.

Pro DNS-Anbieter lässt sich auf jedem Server ein Resolver konfigurieren. Bestehende API-Schlüssel werden nie angezeigt; lass den Schlüssel beim Bearbeiten leer, um ihn zu behalten. Wenn du einen Schlüssel änderst, wird der Proxy neu erstellt, damit er die Zugangsdaten neu lädt. Ein Resolver lässt sich nicht entfernen, solange ihn ein Hostname verwendet, auch ein gelöschter Hostname, der sich wiederherstellen liesse.

Einen Hostnamen entfernen #

Klicke im Hostnamen-Tab neben dem Hostnamen auf Löschen. Kurz darauf antwortet der Dienst nicht mehr darauf, ohne dass du neu deployen musst.

Ein gelöschter Hostname bleibt reserviert, damit kein anderer Dienst den Namen in der Zwischenzeit übernimmt. Um ihn wieder anzuzeigen, stell den Filter Gelöschte Einträge des Tabs auf Mit gelöschten Einträgen oder Nur gelöschte Einträge. Dort holt Wiederherstellen den Hostnamen samt seinen Einstellungen zurück, und Endgültig löschen entfernt ihn für immer und gibt den Namen frei.

Beispiele #

Domain DNS-Eintrag Zeigt auf
erp.firma.de A-Eintrag: erp → 1.2.3.4 Deine Server-IP
odoo.firma.de A-Eintrag: odoo → 1.2.3.4 Deine Server-IP
firma.de A-Eintrag: @ → 1.2.3.4 Deine Server-IP (Root-Domain)

Fehlerbehebung #

Domain funktioniert nach dem Hinzufügen nicht
  • Überprüfe, ob der DNS-Eintrag auf die richtige Server-IP zeigt
    • DNS-Änderungen benötigen möglicherweise Zeit — warte einige Minuten und versuche es erneut
    • Stelle sicher, dass die Ports 80 und 443 auf deinem Server geöffnet sind
SSL-Zertifikat funktioniert nicht
  • Stelle sicher, dass die Domain auf die Server-IP auflöst (DNS muss zuerst konfiguriert sein)
    • Traefik fordert Zertifikate automatisch an, aber die Domain muss erreichbar sein
    • Prüfe den Proxy-Status des Servers im Server-Dashboard
Root-Domain (ohne Subdomain) verwenden?

Erstelle einen A-Eintrag für @ (oder lass den Namen leer, je nach DNS-Anbieter), der auf die IP-Adresse deines Servers zeigt.