E EmDash CMS Everything Guides, use cases, plugins, templates
Deutsch

Zu einer neuen Domain wechseln

Auf dieser Seite

Die Site URL unter Settings > General ist die öffentliche Adresse der Site. Links in E-Mails und Plugins, Sitemaps, robots.txt, hreflang-Links, Social-Image-URLs und im SEO-Bereich gesetzte kanonische Links verwenden sie. Ändern Sie sie mit dem Dialog Change domain, der prüft, ob die neue Domain die Site ausliefert, bevor er umschaltet.

Nur Administratoren können die Domain ändern.

Bevor Sie beginnen

Richten Sie die neue Domain zuerst auf die Site aus. EmDash prüft die Domain während des Wechsels, daher muss sie die Site bereits über https:// ausliefern.

  • Cloudflare Workers: Öffnen Sie im Cloudflare-Dashboard unter Workers & Pages Ihren Worker, wechseln Sie zum Tab Domains und fügen Sie die Domain hinzu. Die Wrangler-Konfiguration finden Sie unter Custom Domains.
  • Node.js und andere Hosts: Erstellen Sie den DNS-Eintrag und das Zertifikat für die Domain und leiten Sie sie an denselben Server weiter, der die aktuelle Adresse ausliefert.

Öffnen Sie https://<neue Domain>/_emdash/admin in einem Browser. Wenn die EmDash-Anmeldeseite erscheint, ist die Domain bereit.

Wenn die Site siteUrl, EMDASH_SITE_URL oder SITE_URL setzt, verwenden Links in E-Mails und Plugins diese Adresse statt der Site URL, und Settings > General nennt sie. Ändern Sie die Konfiguration und stellen Sie die Site erneut bereit, damit auch diese Links umziehen.

Die Domain ändern

  1. Öffnen Sie Settings > General und wählen Sie neben Site URL die Option Change domain.

  2. Geben Sie die neue Domain ein, zum Beispiel www.example.com. Ein vollständiger Origin wie https://www.example.com funktioniert ebenfalls. Pfade und Ports werden nicht akzeptiert.

  3. Wählen Sie Check and switch.

    EmDash fordert unter https://www.example.com/_emdash/api/site/domain-proof einen Einmalcode an. Stimmt der Code überein, speichert es https://www.example.com als Site URL und schließt den Dialog.

Nicht gespeicherte Änderungen unter Settings > General bleiben nach dem Wechsel im Formular erhalten. Speichern Sie sie wie gewohnt.

Wann die neue Adresse wirksam wird

  • E-Mails: E-Mails für Anmeldung, Einladung, Selbstregistrierung, Wiederherstellung und Kommentar-Benachrichtigungen verlinken sofort auf die neue Adresse.
  • Plugins: ctx.site.url ändert sich nach einem Neustart des Servers oder, auf Cloudflare Workers, sobald neue Isolates starten.
  • Sitemaps und robots.txt: Browser und gemeinsam genutzte Caches können die alten Versionen bis zu einer Stunde (Sitemaps) beziehungsweise einen Tag (robots.txt) behalten.

Die alte Adresse liefert die Site weiter aus, bis Sie sie bei Ihrem Host entfernen. Um Besucher von der alten Adresse auf die neue umzuleiten, richten Sie bei Ihrem Host oder DNS-Anbieter eine Weiterleitung ein.

Nach dem Wechsel anmelden

Ein Passkey funktioniert nur unter der Adresse, an der er erstellt wurde. Nach dem Wechsel funktionieren unter der alten Adresse erstellte Passkeys an der neuen nicht. Übertragen Sie Ihre eigene Anmeldung auf die neue Adresse, solange Sie noch an der alten angemeldet sind:

  1. Wählen Sie unter Settings > General unterhalb von Site URL die Option Continue on www.example.com. Die Schaltfläche erscheint, wenn Sie an einer anderen Adresse als der Site URL angemeldet sind. Ist siteUrl konfiguriert, wird stattdessen mit dieser Adresse verglichen.

  2. Wählen Sie auf der Anmeldeseite, die an der neuen Adresse geöffnet wird, Continue. Der Link funktioniert nur einmal und läuft nach 5 Minuten ab.

  3. Settings > Security öffnet sich mit dem Passkey-Formular. Wählen Sie Register Passkey, um einen Passkey für die neue Adresse zu erstellen.

Das funktioniert auch ohne E-Mail. Andere Benutzer können sich an der neuen Adresse mit einem Magic Link anmelden, sobald E-Mail eingerichtet ist, und dort dann einen Passkey hinzufügen. Bis dahin melden sie sich weiter an der alten Adresse an, solange diese die Site noch ausliefert.

Andere Benutzer informieren

Wenn E-Mail eingerichtet ist und Benutzer sich mit Passkeys anmelden, können Administratoren allen anderen Benutzern mitteilen, wo sie sich jetzt anmelden:

  1. Wählen Sie unter Settings > General unterhalb von Site URL die Option Email users.

  2. Wählen Sie Send emails.

Jeder Benutzer, dessen Konto nicht deaktiviert ist (außer Ihnen), erhält eine E-Mail, dass die Site zur konfigurierten siteUrl umgezogen ist, oder zur Site URL, wenn keine gesetzt ist, mit einer Schaltfläche zur dortigen Anmeldeseite. Die E-Mail meldet niemanden an. Sie erklärt, dass Passkeys von der alten Adresse dort nicht funktionieren und dass sich Benutzer zuerst mit einem E-Mail-Link anmelden. Anschließend zeigt eine Meldung, wie viele E-Mails gesendet wurden und wie viele der E-Mail-Anbieter abgelehnt hat. Die E-Mails können pro Site dreimal pro Stunde gesendet werden.

Wenn die Prüfung fehlschlägt

Der Dialog zeigt, warum die Prüfung fehlgeschlagen ist:

  • www.example.com does not resolve to a public address: Die Domain hat noch keinen öffentlichen DNS-Eintrag oder zeigt auf ein privates Netzwerk. Schließen Sie die DNS-Einrichtung ab und versuchen Sie es erneut.
  • Could not reach https://www.example.com: Die Anfrage ist in ein Timeout gelaufen oder die Verbindung ist fehlgeschlagen, zum Beispiel weil das Zertifikat noch nicht bereit ist. Warten Sie einige Minuten und versuchen Sie es erneut.
  • https://example.com redirects to https://www.example.com. Enter that address instead.: Die Domain leitet weiter. Geben Sie die Adresse ein, auf die sie weiterleitet.
  • https://www.example.com does not serve this site yet: Die Domain antwortet, aber nicht mit dieser Site. Möglicherweise zeigt sie noch auf einen früheren Host, oder eine Anmeldeseite wie Cloudflare Access steht davor. Fügen Sie die Domain auf Cloudflare im Tab Domains des Workers als Custom Domain hinzu. Eine Route funktioniert für die Prüfung nicht: Cloudflare führt keinen Worker für Anfragen aus, die der Worker in derselben Zone an seine eigene Route sendet.

Eine Adresse ohne Prüfung verwenden

Wenn die Prüfung fehlschlägt, bietet der Dialog Use … anyway an. Damit wird die Adresse ohne Prüfung gespeichert. Verwenden Sie das, wenn die Site nicht aus dem Internet erreichbar ist, zum Beispiel bei der lokalen Entwicklung unter http://localhost:4321 oder auf einer Staging-Domain hinter einer Anmeldung.

Sitemaps und Such-Metadaten verwenden die gespeicherte Adresse so, wie sie eingegeben wurde, einschließlich eines Pfads wie https://example.com/blog. E-Mails und Plugins verwenden nur deren Origin, und nur wenn sie https:// nutzt oder der Host localhost, 127.0.0.1 oder [::1] ist. Andernfalls verwenden sie weiter die Adresse, unter der die Site eingerichtet wurde.

Prüfen Sie die Adresse sorgfältig, bevor Sie sie auswählen. Nichts bestätigt, dass sie die Site erreicht.