Koppeln Sie Ihre WordPress-Seite an eine andere Domain

Wenn Sie Ihre WordPress-Website unter einer anderen Domain verwenden möchten, können Sie die Installation auf die neue Domain übertragen und anschließend die WordPress-Konfiguration anpassen.

Am einfachsten ist dies über eine vollständige Migration beziehungsweise ein Backup der bestehenden Website. Eine entsprechende Anleitung finden Sie im Artikel So ziehen Sie Ihre WordPress-Seite um.

Alternativ können Sie den Umzug manuell durchführen. Die dafür erforderlichen Schritte werden in dieser Anleitung beschrieben.

Achtung: Bei den folgenden Schritten werden Dateien und Datenbankeinträge Ihrer WordPress-Installation geändert. Erstellen Sie vor Beginn ein vollständiges Backup Ihrer Website-Dateien und Ihrer Datenbank.

Schritt 1 – Website und Datenbank sichern

Prüfen Sie zunächst, ob Ihre bestehende WordPress-Website ordnungsgemäß funktioniert. Erstellen Sie anschließend Sicherungen Ihrer Website-Dateien und der zugehörigen Datenbank.

Website-Dateien sichern

Laden Sie die Dateien Ihrer WordPress-Installation per FTP herunter und speichern Sie diese lokal.

Weitere Informationen finden Sie im Artikel Webspace-Backup via FTP erstellen.

Datenbank sichern

Exportieren Sie die WordPress-Datenbank über phpMyAdmin und speichern Sie die erzeugte SQL-Datei ebenfalls lokal.

Eine Anleitung finden Sie im Artikel Wie mache ich ein Backup meiner Datenbank?.

Schritt 2 – Website-Dateien übertragen

Laden Sie die gesicherten WordPress-Dateien über FTP oder Web-FTP in das Verzeichnis hoch, auf das die neue Domain verweisen soll.

Falls Sie zuvor ein komprimiertes Archiv erstellt haben, entpacken Sie dieses im Zielverzeichnis.

WordPress-Dateien auf den Webspace der neuen Domain übertragen

Schritt 3 – Datenbank importieren

Importieren Sie das zuvor erstellte Datenbank-Backup in die Datenbank, die für die WordPress-Installation unter der neuen Domain verwendet werden soll.

Weitere Informationen finden Sie in folgenden Artikeln:

Schritt 4 – Fehler beim Datenbankimport prüfen

In bestimmten Fällen kann beim Import der Datenbank eine Fehlermeldung erscheinen, wenn der SQL-Dump noch Verweise auf einen alten Datenbanknamen oder Datenbank-Benutzer enthält.

Wenn der Import ohne Fehler abgeschlossen wurde, fahren Sie direkt mit Schritt 5 fort.

Beispiel einer Fehlermeldung beim Import einer SQL-Datenbank

Wenn die Fehlermeldung tatsächlich auf alte Datenbankreferenzen im SQL-Dump zurückzuführen ist, können Sie die Datei prüfen:

  1. Öffnen Sie die SQL-Datei mit einem Text- oder Code-Editor, beispielsweise Visual Studio Code.
  2. Suchen Sie nach dem alten Datenbanknamen beziehungsweise dem alten Datenbank-Benutzer.
  3. Ersetzen Sie nur die tatsächlich betroffenen Datenbankreferenzen durch die neuen Werte.
  4. Speichern Sie die SQL-Datei.
  5. Wiederholen Sie anschließend den Datenbankimport.
Achtung: Nehmen Sie keine pauschalen Änderungen an einer SQL-Datei vor, wenn die Ursache der Fehlermeldung nicht eindeutig ist. Fehlerhafte Änderungen können dazu führen, dass die Datenbank nicht mehr korrekt importiert werden kann.

Schritt 5 – siteurl und home anpassen

Nach dem Import müssen Sie WordPress mitteilen, unter welcher Domain die Website künftig erreichbar sein soll.

  1. Öffnen Sie die importierte Datenbank in phpMyAdmin.
  2. Wählen Sie die Tabelle aus, deren Name auf _options endet.
  3. Suchen Sie in der Spalte option_name nach siteurl und home.
  4. Klicken Sie beim Eintrag siteurl auf Bearbeiten.
  5. Ersetzen Sie im Feld option_value die bisherige URL durch die neue Domain.
  6. Speichern Sie die Änderung.
  7. Wiederholen Sie diese Schritte für home.
Hinweis: Das Tabellenpräfix muss nicht wp_ lauten. Suchen Sie nach der Tabelle, deren Name auf _options endet.
Einträge siteurl und home in der WordPress-Datenbank auswählen
Neue Domain in der WordPress-Datenbank eintragen

Schritt 6 – Datenbankverbindung in wp-config.php anpassen

Wenn für die neue Installation eine andere Datenbank oder ein anderer Datenbank-Benutzer verwendet wird, müssen Sie die entsprechenden Verbindungsdaten in der Datei wp-config.php anpassen.

Prüfen Sie insbesondere folgende Werte:

  • DB_NAME – Name der Datenbank
  • DB_USER – Datenbank-Benutzer
  • DB_PASSWORD – Passwort des Datenbank-Benutzers
  • DB_HOST – Datenbankserver

Weitere Informationen finden Sie im Artikel Datenbank-Verbindungsdaten in WordPress aktualisieren.

Datenbank-Verbindungsdaten in der wp-config.php anpassen

Schritt 7 – Website unter der neuen Domain testen

Rufen Sie die neue Domain im Browser auf und prüfen Sie, ob die WordPress-Website korrekt geladen wird.

Prüfen Sie insbesondere:

  • Startseite und Unterseiten,
  • Bilder und andere Mediendateien,
  • interne Links,
  • Formulare,
  • Login in den WordPress-Administrationsbereich sowie
  • weitere für Ihre Website wichtige Funktionen.
Hinweis: Entfernen oder deaktivieren Sie die bisherige Installation erst, wenn Sie geprüft haben, dass die Website unter der neuen Domain vollständig funktioniert.

Schritt 8 – Permalinks aktualisieren

Nach einem Domainwechsel sollten Sie die Permalink-Einstellungen von WordPress einmal neu speichern. Dadurch können die von WordPress verwendeten Weiterleitungsregeln aktualisiert werden.

  1. Melden Sie sich im Administrationsbereich Ihrer WordPress-Website an.
  2. Öffnen Sie Einstellungen → Permalinks.
  3. Ändern Sie keine Einstellung und klicken Sie auf Änderungen speichern.
Permalink-Einstellungen nach dem WordPress-Domainwechsel speichern

Schritt 9 – Alte URLs in der Datenbank ersetzen

Die Änderung von siteurl und home ersetzt nicht automatisch alle zuvor gespeicherten URLs innerhalb der WordPress-Datenbank.

Bilder, Links, Widgets oder Inhalte von Plugins und Page-Buildern können daher weiterhin auf die alte Domain verweisen.

Bei wenigen betroffenen Inhalten können Sie die Links manuell korrigieren. Bei vielen Einträgen kann beispielsweise das Drittanbieter-Plugin Better Search Replace verwendet werden.

Achtung: Eine fehlerhafte Suchen-und-Ersetzen-Aktion kann Datenbankinhalte verändern und Ihre Website beschädigen. Stellen Sie sicher, dass vor der Änderung ein aktuelles Backup vorhanden ist.
  1. Melden Sie sich im Administrationsbereich Ihrer WordPress-Website an.
  2. Öffnen Sie Plugins → Neues Plugin hinzufügen.
  3. Suchen Sie nach Better Search Replace.
  4. Installieren und aktivieren Sie das Plugin.
  5. Öffnen Sie Werkzeuge → Better Search Replace.
  6. Tragen Sie unter Suchen nach die bisherige Domain ein.
  7. Tragen Sie unter Ersetzen durch die neue Domain ein.
  8. Wählen Sie die Tabellen aus, in denen die Ersetzung durchgeführt werden soll.
  9. Lassen Sie zunächst Als Testlauf ausführen aktiviert und starten Sie den Testlauf.
  10. Prüfen Sie die angezeigten Änderungen.
  11. Wenn das Ergebnis korrekt ist, deaktivieren Sie den Testlauf und führen Sie die Ersetzung durch.
Hinweis: Better Search Replace ist ein Plugin eines Drittanbieters. Bei Fragen oder Problemen mit dem Plugin wenden Sie sich bitte an den jeweiligen Hersteller.

Alternative – WordPress mit einem Plugin umziehen

Alternativ können Sie für die Migration Ihrer WordPress-Website ein Migrations-Plugin verwenden. Beispiele sind:

Hinweis: Bei diesen Plugins handelt es sich um Produkte von Drittanbietern. Erstellen Sie auch bei einer Migration über ein Plugin vorab ein Backup Ihrer Website-Dateien und Datenbank.