Eine eigene Domain gibt deiner Coderblock-App eine einprägsame Produktionsadresse, sodass du nicht die automatisch dem Projekt zugewiesene Coderblock-URL verwenden musst.

Du kannst:

• eine Domain verbinden, die dir bereits gehört, indem du die DNS-Einträge mithilfe des Einrichtungsassistenten konfigurierst;
• direkt in Coderblock eine neue Domain kaufen und die Verwaltung von DNS und SSL der Plattform überlassen.

In diesem Tutorial sehen wir uns beide Optionen an und zeigen dir, wie du nach der Veröffentlichung überprüfst, ob alles ordnungsgemäß funktioniert.

Vor dem Verbinden einer Domain

Bevor du die Domain konfigurierst, solltest du sicherstellen, dass deine App zur Veröffentlichung bereit ist.

Öffne die Live-Entwicklungsvorschau unter <app>.coderblock.dev und teste die wichtigsten Abläufe deiner App, darunter:

• Navigation und Layout auf Mobilgeräten;
• Registrierung und Anmeldung, falls du Benutzerkonten verwendest;
• Formulare und Funktionen mit Datenbankanbindung;
• Stripe-Checkout, falls du Zahlungen aktiviert hast;
• Admin-Bereich und andere geschützte Bereiche.

Falls etwas korrigiert werden muss, kannst du den Coderblock-Agenten einfach in natürlicher Sprache darum bitten. Zum Beispiel:

Gestalte die Navigation responsiv und stelle sicher, dass das Registrierungsformular verständliche Validierungsfehler anzeigt.

Die App wird innerhalb weniger Sekunden in der Live-Vorschau aktualisiert. Die eigene Domain ersetzt die Entwicklungs-URL nicht: Sie fügt der veröffentlichten Produktionsversion deiner App lediglich eine weitere Adresse hinzu.

Wähle nun die gewünschte Konfiguration aus:

1. Eine bereits vorhandene Domain verbinden: Du musst die zugehörigen DNS-Einträge beim Registrar oder DNS-Anbieter ändern, der deine Domain verwaltet.
2. Eine Domain in Coderblock kaufen: Du schließt den Kauf direkt auf der Plattform ab, und Coderblock konfiguriert DNS und SSL automatisch.

---

Option A: Eine bereits vorhandene Domain verbinden

Diese Option eignet sich, wenn du bereits eine Domain bei einem anderen Anbieter gekauft hast und ihre DNS-Einstellungen ändern kannst.

Schritt 1: Domain-Einstellungen öffnen

Öffne dein Coderblock-Projekt und gehe zu Einstellungen → Domains. Wähle die Option zum Verbinden einer vorhandenen Domain aus. Gib die Domain ein, die du für deine App verwenden möchtest, und überprüfe vor dem Fortfahren sorgfältig die Schreibweise.

---

Schritt 2: DNS-Einträge prüfen

Coderblock zeigt dir die DNS-Einträge an, die erforderlich sind, um die Domain mit dem Projekt zu verbinden. Lass diese Seite geöffnet: Du benötigst sie, um die angegebenen Namen, Typen und Werte in das Verwaltungsportal deines DNS-Anbieters zu kopieren. Verwende genau die Einträge, die für dein Projekt angezeigt werden. Ersetze sie nicht durch Werte aus anderen Tutorials oder Konfigurationen für andere Dienste: Das Ziel hängt von der jeweiligen App ab, die du verbindest.

---

Schritt 3: Verwaltungsportal des DNS-Anbieters öffnen

Öffne einen neuen Browser-Tab und melde dich bei dem Dienst an, der die DNS-Einstellungen deiner Domain verwaltet. Das kann der Registrar sein, bei dem du die Domain gekauft hast, oder ein separater DNS-Anbieter. Suche nach dem Bereich für die DNS-Verwaltung. Je nach Anbieter kann er folgendermaßen bezeichnet sein:

• DNS
• DNS-Einträge
• Zonen-Editor
• DNS verwalten

---

Schritt 4: Die von Coderblock angegebenen Einträge hinzufügen

Erstelle oder aktualisiere die DNS-Einträge so, dass sie den von Coderblock angezeigten Werten entsprechen. Kopiere jedes Feld sorgfältig und speichere die Änderungen. Bevor du einen vorhandenen Eintrag löschst, solltest du immer prüfen, wofür er verwendet wird. Eine Domain kann weitere Einträge nutzen, beispielsweise für E-Mail oder andere Dienste außerhalb der Web-App. Ändere nur die Einträge, die mit der zu verbindenden Adresse in Konflikt stehen, und lass alle nicht betroffenen Einträge unverändert. Wenn dein Anbieter den Domainnamen automatisch zum Host-Feld hinzufügt, befolge seine Formatierungshinweise. Entscheidend ist, dass der gespeicherte Eintrag denselben Host und dasselbe Ziel enthält, die Coderblock angibt.

---

Schritt 5: Zu Coderblock zurückkehren

Kehre zu Einstellungen → Domains zurück und setze den Verbindungsvorgang fort. Beachte, dass DNS-Änderungen nicht unbedingt überall gleichzeitig sichtbar werden. Deshalb ist die Domain möglicherweise nicht sofort verfügbar, nachdem du die Einträge gespeichert hast. Falls die Validierung fehlschlägt, vergleiche jedes Feld erneut mit den von Coderblock angezeigten Werten. Achte insbesondere auf:

• Tippfehler;
• doppelte Einträge;
• ältere Einträge, die denselben Host auf ein anderes Ziel verweisen.

App veröffentlichen und in der Produktion testen

Klicke nach erfolgreicher Verbindung auf Veröffentlichen, um die Produktionsversion bereitzustellen. Coderblock veröffentlicht die App unter <app>.coderblock.app oder unter der verbundenen eigenen Domain – SSL ist dabei inbegriffen.

Öffne die eigene Domain in einem neuen Tab und prüfe, ob:

• die Seite über https:// geladen wird;
• der Browser die richtige Domain anzeigt;
• Navigationslinks unter der Produktionsadresse bleiben;
• Authentifizierung und geschützte Seiten funktionieren;
• Formulare Daten korrekt aus der Postgres-Datenbank lesen und in sie schreiben;
• Zahlungen den vorgesehenen Stripe-Modus verwenden;
• Bilder und Dateien korrekt aus dem Storage geladen werden.

Wenn die App öffentlich zugänglich sein soll, solltest du sie sowohl auf dem Desktop als auch auf Mobilgeräten testen. Und die Arbeit endet nicht mit der Domain: Du kannst deine App weiterhin per Chat bearbeiten, Aktualisierungen in der Live-Vorschau prüfen und sie erneut veröffentlichen, sobald du die Änderungen in die Produktion übernehmen möchtest.

Option B: Eine Domain direkt in Coderblock kaufen

Wenn du noch keine passende Domain besitzt, kannst du sie direkt auf der Plattform kaufen. Öffne Einstellungen → Domains und wähle die Option zum Kauf einer neuen Domain aus. Wähle deine gewünschte Domain und schließe den Kauf innerhalb von Coderblock ab.

In diesem Fall werden DNS und SSL automatisch konfiguriert. Du musst daher keine Einträge kopieren oder das DNS-Verwaltungsportal eines externen Dienstes manuell bearbeiten. Veröffentliche die App nach Abschluss des Kaufs und der Konfiguration und führe dieselben Prüfungen wie im vorherigen Abschnitt durch.

Prüfe insbesondere:

• HTTPS-Adresse;
• Anmeldung und Registrierung;
• Formulare;
• Dateien und Bilder;
• gegebenenfalls Zahlungsabläufe.

Wenn die Domain nicht geladen wird

Falls die verbundene Domain nicht wie erwartet funktioniert, gehe zunächst diese Checkliste durch:

1. Domain prüfen. Stelle sicher, dass die in Coderblock eingegebene Domain genau der Domain entspricht, deren DNS-Einträge du geändert hast.
2. DNS-Einträge erneut prüfen. Schon ein einziges falsches Zeichen kann eine erfolgreiche Verbindung verhindern.
3. Nach Konflikten suchen. Ein alter Eintrag verweist denselben Host möglicherweise noch auf einen anderen Dienst.
4. DNS-Aktualisierung abwarten. Es kann einige Zeit dauern, bis Änderungen überall übernommen wurden.
5. Prüfen, ob die App veröffentlicht wurde. Die Entwicklungsvorschau und die Produktionsversion sind getrennte Umgebungen.
6. Vollständige HTTPS-Adresse testen. Gib die URL direkt mit https:// ein.
7. Privates Browserfenster verwenden. So kannst du Probleme durch Cache, Weiterleitungen oder alte, im Browser gespeicherte Versionen ausschließen.

Wichtig: Ändere die DNS-Einträge nicht ständig, während die Konfiguration noch aktualisiert wird. Wenn die Werte den Angaben von Coderblock entsprechen, können unnötige Änderungen den Vorgang zusätzlich erschweren.

Abschließende Checkliste

Die Domain ist korrekt konfiguriert, wenn:

• sie im Projekt unter Einstellungen → Domains angezeigt wird;
• die DNS-Einträge der von Coderblock angegebenen Konfiguration entsprechen oder nach einem Kauf auf der Plattform automatisch konfiguriert wurden;
• die App veröffentlicht wurde;
• die eigene Domain über HTTPS erreichbar ist;
• die wichtigsten Abläufe der App in der Produktion ordnungsgemäß funktionieren.

Deine Domain ist bereit

Deine Coderblock-App verfügt nun über eine eigene Produktionsadresse und kann mit Kunden, Benutzern und Stakeholdern geteilt werden. Du kannst sie ab jetzt wie gewohnt weiterentwickeln: Chat → Änderung → Vorschau → Veröffentlichung. Die eigene Domain bleibt dabei der Zugangspunkt zur Live-Version.