Joomla 3.10 nach 4.x migrieren

Der Schritt von Joomla 3.10 auf Joomla 4 ist die einfachste Etappe auf dem Weg zu Joomla 6: Die Joomla-Kernerweiterungen lassen sich mit einem Klick über die Joomla-Aktualisierung umstellen. Der eigentliche Aufwand steckt in den Erweiterungen und im Template von Drittanbietern. Manche lassen sich ebenfalls mit einem Klick aktualisieren, andere nicht.

Technische Kenntnisse sind erforderlich. Ob Sie sich das zutrauen, zeigt der Selbsttest auf der Übersichtsseite der Anleitungen.

Wichtig: Das reguläre Supportende von Joomla 3.10 war am 17. August 2023, und auch Joomla 4 erhält keine Sicherheitsupdates mehr. Betrachten Sie Joomla 4 deshalb nur als Zwischenschritt auf dem Weg zu Joomla 6. Planen Sie die Folgeschritte Joomla 4.x nach 5.x und Joomla 5.x nach 6.x gleich mit ein.

Läuft Ihre Website noch auf einer Version vor 3.10 (zum Beispiel 3.9)? Dann aktualisieren Sie zuerst auf die letzte Version 3.10.

Das Wichtigste in Kürze

• Die Website muss auf der letzten Version von Joomla 3.10 laufen.
• Der Server muss die technischen Anforderungen von Joomla 4 erfüllen.
• Alle Erweiterungen und das Template müssen mit Joomla 4 laufen oder vorher entfernt werden.
• Das Template Protostar verschwindet bei der Migration, Sie brauchen ein eigenes oder ein anderes Template.
• Arbeiten Sie zuerst auf einer Kopie der Website, nicht auf der Live-Seite.

Schritt 1: Voraussetzungen prüfen

Öffnen Sie im Administrationsbereich System → Systeminformationen und prüfen Sie:

• Joomla-Version: Die Ausgangsversion muss die letzte 3.10.x sein.
• PHP und Datenbank: Joomla 4 verlangt laut Joomla-Dokumentation mindestens PHP 7.2.5 und MySQL 5.6, empfohlen werden neuere Versionen (PHP 8.2, MySQL 8.0). Auch MariaDB und PostgreSQL werden unterstützt.

Beachten Sie dabei den gesamten Weg bis Joomla 6: Joomla 5 braucht mindestens PHP 8.1 und MySQL 8.0.13, Joomla 6 mindestens PHP 8.3. Joomla 3.10 läuft allerdings nicht mit den neuesten PHP-Versionen. Stellen Sie PHP deshalb schrittweise um und prüfen Sie jeweils, welche Version die aktuell installierte Joomla-Version unterstützt. Bei Fragen hilft der Support Ihres Hosters.

Schritt 2: Testumgebung einrichten

1. Erstellen Sie ein komplettes Backup der Live-Seite (Dateien und Datenbank), wie auf der Übersichtsseite der Anleitungen im Abschnitt „Ganz wichtig: das Backup“ beschrieben.
2. Legen Sie eine neue Datenbank mit eigenem Benutzer für die Kopie an.
3. Stellen Sie das Backup in einer Testumgebung wieder her, zum Beispiel auf einer Subdomain, in einem Unterverzeichnis, auf Ihrem eigenen Rechner (XAMPP, WAMP, MAMP oder LAMP) oder in einem neuen Hosting-Konto auf einer temporären Domain, falls Sie den Hoster wechseln möchten.
4. Aktualisieren Sie die Kopie auf die letzte Wartungsversion von Joomla 3.10.
5. Prüfen Sie unter Erweiterungen → Verwalten → Datenbank, ob die Datenbankstruktur aktuell ist. Zeigt Joomla Fehler an, klicken Sie auf „Korrigieren“.
6. Leeren Sie den Papierkorb: Beiträge, Kategorien und Menüeinträge, die dort liegen, können die Migration stören. Löschen Sie dazugehörige Medien nur, wenn Sie sie nirgends mehr benötigen.
7. Testen Sie die Kopie und erstellen Sie danach noch ein Backup.

Schritt 3: Erweiterungen und Template prüfen

Jetzt prüfen Sie jede installierte Erweiterung. Sie arbeiten dafür mit zwei Bereichen: der Vorabprüfung in der Joomla-Aktualisierung und der Erweiterungsverwaltung (Erweiterungen → Verwalten → Verwalten).

Die Vorabprüfung aufrufen

1. Öffnen Sie Komponenten → Joomla-Aktualisierung. Dort sollte stehen, dass keine Updates gefunden wurden. Ist das nicht der Fall, aktualisieren Sie auf die letzte 3.10.x, testen und erstellen ein neues Backup.
2. Klicken Sie oben rechts auf Optionen.
3. Stellen Sie den Update-Kanal auf „Joomla Next“ und klicken Sie auf Speichern & Schließen.
4. Joomla zeigt nun die installierte und die neueste Version sowie die Anforderungen an Joomla 4. Weist es auf ein nicht geeignetes System oder auf Erweiterungen hin, steht das hier.

Aktualisieren Sie jetzt noch nicht auf Joomla 4. Dieser Schritt dient nur dazu, Erweiterungen und Website vorzubereiten.

Achten Sie in der Vorabprüfung auf die Kennzeichen der Erweiterungen. Die Angaben „Ja“ und „Nein“ stimmen meist. Steht dort „Missing Compatibility Tag“, hat der Hersteller keine Angabe hinterlegt, und Sie müssen ihn selbst fragen. Notieren Sie sich alle Erweiterungen in einer eigenen Liste, auch solche, die die Vorabprüfung nicht nennt.

Altlasten entfernen

Wurde Ihre Website früher von Joomla 2.5 auf 3 umgestellt, können Reste liegen geblieben sein, die vor dem Update auf Joomla 4 deinstalliert werden müssen:

• plg_content_geshi
• PKG_JOOMLA
• Bluestork (Administrator-Template)
• Beez_20, Beez5 und Atomic (Site-Templates)

Deinstallieren Sie außerdem alle Templates, die Sie nicht mehr nutzen. Behalten Sie nur Protostar und Beez3 (Site), Isis und Hathor (Administration) sowie Ihr eigenes Template.

Das Template

Protostar ist nicht mit Joomla 4 kompatibel und verschwindet bei der Migration. Ein als „Standard“ gesetztes Template lässt sich nicht deinstallieren, stellen Sie dafür zuerst Protostar oder Beez3 als Standard ein. Planen Sie, nach dem Update ein Joomla-4-taugliches Template zu installieren. Kann Ihr bisheriges Template nicht mitwandern, brauchen Sie ein neues oder umgebautes Template.

Erweiterungen aktualisieren und aufräumen

1. Aktualisieren: Aktualisieren Sie alle Erweiterungen, die Sie behalten, auf die neueste Version. Unter Erweiterungen → Verwalten → Aktualisieren funktioniert das mit „Aktualisierungen suchen“, außerdem zeigt Joomla in der Erweiterungsverwaltung einen Hinweis zur Kompatibilität an. Das gilt aber nur für Erweiterungen, die den Joomla-Update-Mechanismus nutzen. Alle anderen müssen Sie von Hand prüfen.
2. Entfernen: Öffnen Sie Erweiterungen → Verwalten → Verwalten und blenden Sie über die Suchwerkzeuge die Filter ein. Wählen Sie zuerst den Typ „Paket“. Deinstallieren Sie ein Paket, entfernt Joomla die zugehörigen Module, Plugins und Komponenten gleich mit. Deinstallieren Sie Pakete, die Sie nicht mehr brauchen oder die nicht mit Joomla 4 laufen.
3. Alle Typen durchgehen: Wiederholen Sie das für Komponente, Datei, Sprache, Bibliothek, Modul, Plugin und Template. Erweiterungen mit dem Autor „Joomla! Project“ lassen Sie unangetastet.
4. Versionen notieren: Halten Sie fest, welche Version jedes Pakets und jeder Komponente aktuell läuft, die Sie behalten.

Prüfen Sie bei jeder Erweiterung, ob es Joomla 3.10 und Joomla 4 im selben Paket gibt. Dann reicht ein Klick. Gibt es getrennte Pakete, gilt meist einer von zwei Wegen: Entweder erkennt die Erweiterung den Wechsel selbst und funktioniert weiter (bestätigen lassen!), oder Sie deinstallieren sie in Joomla 3.10 und installieren nach der Migration die Joomla-4-Version. Das ist zum Beispiel bei manchen Inhalts-Plugins einfach. Fragen Sie im Zweifel den Hersteller.

Besonderheiten bei Joomla 4

• Suche (com_search): Die klassische Suche gehört in Joomla 4 nicht mehr zum Kern. Sie wird mit der Website migriert und danach wie eine Erweiterung eines Drittanbieters über den Installer aktualisiert. Joomla empfiehlt, künftig die Smart Search zu nutzen. Beim späteren Schritt auf Joomla 5 muss die alte Suche ohnehin entfallen, wechseln Sie deshalb am besten jetzt.
• Weblinks: Die Komponente wird, falls Sie sie nutzen, mit migriert und ist weiter erhältlich.
• Routing: Joomla 4 kennt nur noch das moderne Routing. Verwenden Sie bisher das alte (Legacy-)Routing, stellt Joomla bei der Migration automatisch um. Prüfen Sie danach mit einem Werkzeug zur Link-Prüfung, ob noch alle Adressen funktionieren.

Schritt 4: Das Update auf Joomla 4 durchführen

Führen Sie dieses Update zuerst in der Testumgebung durch. Sind alle Erweiterungen entweder aktualisiert oder entfernt, gehen Sie so vor:

1. Öffnen Sie System → Globale Konfiguration → Reiter „Server“ und stellen Sie die Fehlerberichterstattung von „System-Standard“ auf „Maximal“. Speichern Sie.
2. Erstellen Sie ein weiteres Backup.
3. Öffnen Sie Komponenten → Joomla-Aktualisierung. Der Update-Kanal steht noch auf „Joomla Next“. Joomla zeigt die installierte und die neueste Version und die Anforderungen an.
4. Wird das Update nicht angezeigt, öffnen Sie Erweiterungen → Verwalten → Aktualisieren und klicken in der Werkzeugleiste auf „Cache leeren“. Danach sollte es erscheinen.
5. Klicken Sie auf „Update installieren“. Der Vorgang kann einige Minuten dauern, denn Joomla entpackt weit über 12.000 Dateien. Unterbrechen Sie ihn nicht.
6. Nach Abschluss werden Sie eventuell abgemeldet. Melden Sie sich im Backend an. Sie sehen nun die neue Oberfläche von Joomla 4.

Schritt 5: Nach dem Update prüfen

1. Öffnen Sie System → Wartung → Datenbank und klicken Sie bei angezeigten Fehlern auf „Struktur aktualisieren“.
2. Prüfen Sie unter System → Installieren → Entdecken, ob Erweiterungen zur Installation bereitstehen. Das sollte nicht der Fall sein.
3. Rufen Sie das Frontend auf. Es sollte erscheinen, auch wenn es noch nicht mit dem richtigen Template dargestellt wird. Erscheint es nicht, suchen Sie in der Dokumentation von Joomla nach den häufigen Migrationsfehlern.
4. Erstellen Sie ein Backup.
5. Installieren Sie Ihr neues Template und weitere Erweiterungen, falls nötig, und konfigurieren Sie sie. Machen Sie dabei oft Backups.
6. Prüfen Sie die Website mit einem Link-Prüfer und korrigieren Sie fehlerhafte Verweise.
7. Testen Sie alles: Menüs, Beiträge, Formulare, Suche, Anmeldung, Mehrsprachigkeit, Bilder und Downloads, im Frontend und im Backend.
8. Stellen Sie die Fehlerberichterstattung unter System → Globale Konfiguration → Reiter „Server“ wieder auf „System-Standard“.
9. Lesen Sie die Nachinstallationsmeldungen von Joomla und arbeiten Sie sie ab.
10. Setzen Sie den Update-Kanal unter System → Update → Joomla → Optionen wieder auf „Standard“. Das ist eine Empfehlung, kein Pflichtschritt.

Schritt 6: Live gehen

Funktioniert die Testumgebung einwandfrei, schalten Sie die Joomla-4-Seite für die Besucher frei:

1. Sichern Sie die Live-Seite (Joomla 3.10) ein letztes Mal.
2. Sichern Sie die Joomla-4-Seite und verschieben oder stellen Sie sie im Hauptverzeichnis wieder her. Haben Sie in einem neuen Hosting-Konto gearbeitet, stellen Sie stattdessen die Domain bzw. die Nameserver um.
3. Testen Sie noch einmal.
4. Haben Sie früher Sicherheitseinstellungen in der .htaccess-Datei vorgenommen, müssen Sie diese eventuell für Joomla 4 anpassen. Prüfen Sie die entsprechende Hinweisseite von Joomla zu den .htaccess-Änderungen.
5. Entfernen Sie die alte Joomla-3.10-Seite innerhalb weniger Tage vom Server oder schützen Sie das Verzeichnis zumindest mit einem Passwort (z. B. per .htaccess). Entfernen Sie auch alle Test- und Entwicklungsumgebungen oder halten Sie sie aktuell. Veraltete Kopien sind ein Einfallstor für Angriffe.

Achtung: Haben sich auf der Live-Seite Inhalte geändert, während Sie die Kopie bearbeitet haben (neue Beiträge, Benutzer, Formulareingaben), müssen Sie diese Änderungen vor dem Livegang in die neue Seite übernehmen. Das geht von Hand (dabei dieselben Benutzer-IDs verwenden, in der richtigen Reihenfolge) oder mit einer Erweiterung. Am einfachsten vermeiden Sie das, indem Sie den Zeitraum zwischen Sicherung und Livegang kurz halten.

Wie geht es weiter?

Aktualisieren Sie Joomla anschließend auf die letzte Version von 4.4. Von dort führt der Weg auf Joomla 5, siehe Joomla 4.x nach 5.x, und danach auf Joomla 6. Planen Sie diese Schritte zeitnah, denn Joomla 4 ist nur eine Zwischenstation und erhält keine Sicherheitsupdates mehr.

Wenn etwas schiefgeht

Dank der Fehlerberichterstattung auf „Maximal“ zeigt Joomla meist, welche Erweiterung das Problem verursacht. Deaktivieren oder entfernen Sie sie. Ist der Administrationsbereich nicht erreichbar, lässt sich eine Erweiterung direkt in der Datenbank abschalten: In der Tabelle #__extensions steht dafür das Feld enabled (1 = aktiv, 0 = deaktiviert), ein Erweiterungspaket kann mehrere Einträge haben. Beachten Sie den Tabellenpräfix Ihrer Installation. Hilft das nicht, stellen Sie die Website aus dem Backup wieder her und suchen die Ursache in der Testumgebung.

Wie Sie die Wiederherstellung durchführen, steht auf der Übersichtsseite der Anleitungen im Abschnitt „Wenn die Migration misslingt“.

Unsicher oder keine Zeit?

Gerade bei vielen Erweiterungen, einem älteren Template oder einer Website, die nicht ausfallen darf, ist es oft einfacher, die Migration abzugeben. Wir prüfen Ihre Website und machen Ihnen ein Festpreisangebot.

Zur Migrationsanfrage

Alle Anleitungen im Überblick