Zum Inhalt springen
SONOYA.com
Selfhosting & Web

WordPress umziehen ohne Plugin: mit WP-CLI

WordPress auf neuen Server oder neue Domain umziehen, ohne Plugin und Größenlimit: mit rsync, wp db export und wp search-replace samt Trockenlauf.

Von

Symbol eines Umzugswagens auf dunklem Verlauf als Bild für den Umzug einer WordPress-Website auf einen neuen Server

Umzugs-Plugins sind bequem, bis die Website zu groß wird: Das Export-Archiv übersteigt das Upload-Limit, der Import bricht nach der Hälfte ab, oder die kostenlose Version verlangt plötzlich ein Upgrade. Dabei braucht ein WordPress-Umzug nur zwei Dinge, die Dateien und die Datenbank, und beides bewegst Du mit ein paar Befehlen auf der Kommandozeile zuverlässiger als mit jedem Plugin. Diese Anleitung zeigt den Umzug auf einen neuen Server, auf Wunsch auch mit neuer Domain, mit WP-CLI und rsync.

Den kompletten Ablauf habe ich mit WordPress 7.1.4, WP-CLI 2.12 und MariaDB 11 in Docker durchgespielt: Export, Kopie, Import und das Ersetzen der Domain inklusive serialisierter Plugin-Einstellungen. Die Ausgaben in diesem Artikel stammen aus diesem Test.

Der Ablauf im Überblick

Eine WordPress-Website besteht aus dem Ordner mit den Dateien (WordPress selbst, Themes, Plugins, Uploads und die wp-config.php) und aus der Datenbank mit allen Beiträgen und Einstellungen. Der Umzug läuft deshalb immer in derselben Reihenfolge:

  1. Datenbank auf dem alten Server exportieren.
  2. Dateien inklusive Export auf den neuen Server kopieren.
  3. Leere Datenbank auf dem neuen Server anlegen und die Zugangsdaten in wp-config.php eintragen.
  4. Export importieren.
  5. Bei neuer Domain die Adressen in der Datenbank ersetzen.
  6. Prüfen, DNS umstellen und aufräumen.

Du brauchst SSH-Zugriff auf beide Server und WP-CLI auf beiden. Ob es installiert ist, zeigt wp --info. Auf dem neuen Server müssen ein Webserver, PHP und MariaDB oder MySQL schon laufen. Falls Du noch einen Zielserver suchst: Ein kleines Droplet bei DigitalOcean (Affiliate Link) reicht für die meisten Blogs, neue Konten bekommen über den Link Startguthaben zum Ausprobieren.

In den Beispielen liegt WordPress unter /var/www/html, die alte Domain ist https://alt.de, die neue https://neu.de. Ersetze diese Werte jeweils durch Deine eigenen.

Schritt 1: Datenbank auf dem alten Server exportieren

Melde Dich per SSH auf dem alten Server an und wechsle in den WordPress-Ordner:

Code
cd /var/www/html

Exportiere die Datenbank mit WP-CLI in eine Datei:

Code
wp db export backup.sql

WP-CLI liest die Zugangsdaten selbst aus der wp-config.php, Du musst also kein Datenbankpasswort eingeben. Am Ende steht Success: Exported to 'backup.sql'. Die Datei liegt jetzt im WordPress-Ordner und wandert im nächsten Schritt automatisch mit.

Gehört der Ordner einem anderen Benutzer, etwa www-data, setzt Du vor jeden wp-Befehl sudo -u www-data, also zum Beispiel sudo -u www-data wp db export backup.sql. Als root solltest Du WP-CLI nicht ausführen, es bricht dann mit einer Warnung ab.

Ab jetzt sollte auf der alten Website nichts mehr geändert werden. Neue Kommentare oder Bestellungen, die nach dem Export eingehen, fehlen sonst auf dem neuen Server.

Schritt 2: Dateien mit rsync kopieren

Kopiere den kompletten Ordner vom alten auf den neuen Server. Auf dem alten Server gibst Du ein:

Code
rsync -avz /var/www/html/ benutzer@neuer-server:/var/www/html/

Ersetze benutzer durch Deinen SSH-Benutzer und neuer-server durch die IP-Adresse oder den Hostnamen des neuen Servers. -a übernimmt Rechte und Zeitstempel, -v zeigt jede Datei, -z komprimiert während der Übertragung. Wichtig ist der Schrägstrich am Ende von /var/www/html/: Mit ihm kopiert rsync den Inhalt des Ordners, ohne ihn landet ein zusätzlicher Unterordner html im Ziel.

Darf Dein SSH-Benutzer auf dem neuen Server nicht in /var/www/html schreiben, gib ihm den Ordner vorher dort mit sudo chown -R benutzer:benutzer /var/www/html. Die richtigen Rechte für den Webserver setzen wir in Schritt 6. Bricht die Übertragung ab, startest Du denselben Befehl einfach erneut, rsync überträgt dann nur, was noch fehlt. Klappt die Anmeldung am neuen Server nicht, hilft SSH-Schlüssel erstellen: ed25519 Schritt für Schritt weiter.

Schritt 3: Datenbank auf dem neuen Server anlegen

Melde Dich auf dem neuen Server an und öffne die Datenbank-Konsole:

Code
sudo mariadb

Lege eine Datenbank und einen Benutzer an. Ersetze geheimes-passwort durch ein eigenes, langes Passwort:

Code
CREATE DATABASE wordpress;
CREATE USER 'wpuser'@'localhost' IDENTIFIED BY 'geheimes-passwort';
GRANT ALL PRIVILEGES ON wordpress.* TO 'wpuser'@'localhost';
EXIT;

Trag die neuen Zugangsdaten in die kopierte wp-config.php ein. Auch das erledigt WP-CLI, ohne dass Du die Datei im Editor öffnen musst:

Code
cd /var/www/html
wp config set DB_NAME wordpress
wp config set DB_USER wpuser
wp config set DB_PASSWORD 'geheimes-passwort'
wp config set DB_HOST localhost

Jeder Befehl bestätigt mit Success: Updated the constant .... Sind Benutzer und Passwort auf beiden Servern gleich, überspringst Du die passenden Zeilen.

Schritt 4: Datenbank importieren

Jetzt kommt der Export in die neue Datenbank:

Code
wp db import backup.sql

Prüf direkt danach, ob die Verbindung steht und die Daten angekommen sind:

Code
wp option get home

Der Befehl gibt die Adresse der Website aus. Steht dort noch https://alt.de, ist das bei einem Domainwechsel richtig, denn die Adressen ersetzen wir erst im nächsten Schritt. Ziehst Du nur auf einen neuen Server um und die Domain bleibt gleich, überspringst Du Schritt 5.

Schritt 5: Adressen ersetzen, erst im Trockenlauf

WordPress speichert die Domain nicht nur in den Einstellungen, sondern in jedem Beitrag mit Link oder Bild und in vielen Plugin-Einstellungen. Ein einfaches Suchen und Ersetzen in der SQL-Datei würde dabei serialisierte Daten zerstören: Das sind gespeicherte PHP-Werte, die die Länge jeder Zeichenkette mitführen. Ändert sich die Länge der Domain, passt diese Angabe nicht mehr, und die Einstellung ist verloren. wp search-replace kennt das Format und rechnet die Längen korrekt um.

Starte immer mit einem Trockenlauf, der nichts verändert:

Code
wp search-replace 'https://alt.de' 'https://neu.de' --all-tables --skip-columns=guid --dry-run --report-changed-only

--all-tables bezieht auch Tabellen von Plugins mit ein, --report-changed-only blendet alle Spalten ohne Treffer aus, und --skip-columns=guid lässt die interne Kennung der Beiträge unangetastet. Diese GUID dient Feedreadern als dauerhafte ID, und die WordPress-Doku zum Umzug rät ausdrücklich davon ab, sie zu ändern. In meinem Test sah die Ausgabe so aus:

Code
Table	Column	Replacements	Type
wp_options	option_value	3	PHP
wp_posts	post_content	3	SQL
wp_users	user_url	1	SQL
Success: 7 replacements to be made.

Die Zeile mit dem Typ PHP zeigt, dass WP-CLI dort serialisierte Daten gefunden hat und sie sicher behandelt. Wirken die Zahlen plausibel, führst Du denselben Befehl ohne --dry-run aus:

Code
wp search-replace 'https://alt.de' 'https://neu.de' --all-tables --skip-columns=guid --report-changed-only

Die Erfolgsmeldung lautet dann Success: Made 7 replacements. Wiederholst Du jetzt den Trockenlauf, muss er 0 replacements to be made melden. Lief die alte Website noch unter http://, startest Du anschließend einen zweiten Durchgang mit 'http://alt.de' als Suchbegriff, sonst bleiben alte Bildadressen ohne HTTPS übrig.

Der Befehl ist genauso nützlich, wenn Du nur von http auf https wechselst. Was Du bei einem Domainwechsel zusätzlich für Google tun musst, also Weiterleitungen und Adressänderung in der Search Console, steht in Domain-Wechsel ohne SEO-Verluste: so gelingt der Umzug.

Erzeuge die Regeln für die Permalinks neu und leere den Objekt-Cache:

Code
wp rewrite flush
wp cache flush

Stell sicher, dass der Webserver die Dateien lesen und Uploads schreiben darf. Bei Apache und Nginx unter Debian und Ubuntu ist das der Benutzer www-data:

Code
sudo chown -R www-data:www-data /var/www/html

Bevor Du die DNS-Einträge der Domain auf den neuen Server umstellst, kannst Du ihn schon testen. Trag dazu auf Deinem eigenen Rechner in die Datei /etc/hosts eine Zeile mit der IP-Adresse des neuen Servers und der Domain ein, zum Beispiel 203.0.113.10 neu.de, und öffne die Website im Browser. Funktionieren Startseite, ein Beitrag, ein Bild und die Anmeldung unter /wp-admin, stellst Du die DNS-Einträge um und entfernst die Zeile wieder aus /etc/hosts.

Zum Schluss ein Punkt, den viele vergessen: Lösch den Datenbank-Export auf beiden Servern. Im Webordner ist die Datei sonst für jeden unter https://neu.de/backup.sql abrufbar, inklusive aller Benutzerdaten.

Code
sudo rm /var/www/html/backup.sql

Typische Fehler nach dem Umzug

„Fehler beim Aufbau einer Datenbankverbindung“. Die Zugangsdaten in wp-config.php passen nicht zur neuen Datenbank. Prüf sie mit wp config get DB_NAME und den anderen drei Werten aus Schritt 3. Bei manchen Hostern ist DB_HOST nicht localhost, sondern ein eigener Datenbank-Hostname aus dem Kundenmenü.

Startseite geht, jeder Beitrag zeigt 404. Die Permalink-Regeln fehlen. Unter Apache muss die Datei .htaccess mitkopiert worden sein und AllowOverride All für den Ordner gelten. Unter Nginx braucht die Serverkonfiguration die Zeile try_files $uri $uri/ /index.php?$args;. Danach hilft noch einmal wp rewrite flush.

Weiterleitung auf die alte Domain. Stehen in der wp-config.php die Konstanten WP_HOME oder WP_SITEURL, überschreiben sie die Werte aus der Datenbank. Prüf mit wp config get WP_HOME, ob sie gesetzt sind, und pass sie an.

Fehlende Bilder oder Warnung „nicht sicher“. Es gibt noch Adressen mit der alten Domain oder mit http://. Ein Trockenlauf von wp search-replace mit dem alten Wert zeigt, in welcher Tabelle sie stecken.

Taucht nach dem Umzug statt der Website die Meldung über einen kritischen Fehler auf, liegt das meist an einer anderen PHP-Version auf dem neuen Server. Wie Du das betroffene Plugin findest, zeigt WordPress „kritischer Fehler“: Ursache finden und beheben.

Der Vorteil dieses Wegs zeigt sich beim nächsten Umzug: Er funktioniert unabhängig von der Größe der Website und ohne Plugin-Lizenz, und mit dem Trockenlauf siehst Du vorher genau, was sich in der Datenbank ändert.

Weiterlesen.