Joomla 4.x nach 5.x migrieren
Der Schritt von Joomla 4 auf Joomla 5 ist eine einfache Etappe auf dem Weg zu Joomla 6: Die vorhandene Installation wird aktualisiert, ein Neuaufbau ist nicht nötig. Der eigentliche Aufwand steckt in der Vorbereitung, vor allem bei Erweiterungen und Template.
Technische Kenntnisse sind erforderlich. Ob Sie sich das zutrauen, zeigt der Selbsttest auf der Übersichtsseite der Anleitungen.
Läuft Ihre Website noch auf Joomla 3.10? Dann gehen Sie zuerst die Anleitung Joomla 3.10 nach 4.x durch. Joomla 4 wird nicht mehr unterstützt, betrachten Sie diese Version deshalb nur als Zwischenschritt auf dem Weg zu Joomla 6.
Das Wichtigste in Kürze
- Die Website muss auf der letzten Version von Joomla 4.4 laufen.
- Der Server braucht PHP 8.1 oder neuer und eine passende Datenbankversion, zum Beispiel MySQL 8.0.13.
- Alle Erweiterungen und das Template müssen mit Joomla 5 laufen.
- Die alte Suchkomponente com_search und das Google-reCAPTCHA-Plugin gibt es in Joomla 5 nicht mehr. Sie müssen vorher ersetzt werden.
- Machen Sie zuerst einen Testlauf auf einer Kopie der Website.
Schritt 1: Voraussetzungen prüfen
Öffnen Sie im Administrationsbereich System → Systeminformationen und prüfen Sie:
- Joomla-Version: Die Ausgangsversion muss Joomla 4.4.x sein. Läuft Ihre Website auf einer älteren Version, aktualisieren Sie zuerst auf 4.4.x.
- PHP-Version: mindestens PHP 8.1.
- Datenbank: MySQL ab 8.0.13, MariaDB ab 10.4 oder PostgreSQL ab 12.
Erfüllt der Server diese Anforderungen nicht, erscheint die Update-Möglichkeit in der Joomla-Aktualisierung gar nicht. Gerade die Datenbankversion ist bei älteren Hosting-Tarifen ein häufiger Stolperstein. Fragen Sie in diesem Fall Ihren Hoster, ob sich Datenbank und PHP-Version anheben lassen. Prüfen Sie nach einer Umstellung, ob Ihre Website fehlerfrei läuft, bevor Sie weitermachen.
Schritt 2: Erweiterungen und Template prüfen
Rufen Sie System → Verwalten → Erweiterungen auf und notieren Sie alle Erweiterungen von Drittanbietern, dazu Ihr Template. Für jede gilt es zu klären, ob sie mit Joomla 5 läuft. Dafür gibt es drei Wege:
- Herstellerseite: Dort steht, ob und ab welcher Version die Erweiterung für Joomla 5 freigegeben ist.
- Joomla Extensions Directory (JED): Dort zeigen Erweiterungen eine Kennzeichnung für Joomla-5-Kompatibilität, mit oder ohne das Kompatibilitäts-Plugin.
- Testlauf: Der sicherste Weg ist ein Probe-Update auf einer Kopie (siehe Schritt 4).
Je nach Erweiterung kann Folgendes passieren: Sie läuft ohne Einschränkung unter Joomla 5, sie läuft nur mit dem Kompatibilitäts-Plugin, sie scheint zu laufen und versagt erst bei der Benutzung, oder sie legt die ganze Website lahm. Deshalb lohnt sich der Test.
Das Kompatibilitäts-Plugin
Das Plugin „Behaviour – Backward Compatibility“ versucht, älteren Erweiterungen weiter Zugriff auf Funktionen zu geben, die es in Joomla 5 nicht mehr gibt. Beim Update von Joomla 4.4 auf 5 wird es automatisch aktiviert.
Ob Ihre Erweiterungen auch ohne dieses Plugin laufen, sollten Sie nach dem Update in einer Testumgebung prüfen. Das ist wichtig für den nächsten Schritt: Für das Update auf Joomla 6 muss es deaktiviert werden können, und für Joomla-4-Erweiterungen wird es in Joomla 6 keine Unterstützung mehr geben.
Besonderheiten bei Joomla 5
- Cassiopeia bleibt das Standard-Template. Eigene Anpassungen funktionieren in der Regel weiter, testen Sie sie trotzdem. Bootstrap 5.3 gibt es schon in Joomla 4.4, Darstellungsprobleme würden also dort schon sichtbar.
- Google reCAPTCHA: Das zugehörige Plugin gibt es in Joomla 5 nicht mehr und wird beim Update entfernt. Wenn Sie es einsetzen, wechseln Sie vorher zu „Invisible reCAPTCHA“ (neue Schlüssel nötig) oder zu einer Lösung von einem Drittanbieter.
- Weblinks: Die Erweiterung läuft in Joomla 5 ohne Kompatibilitäts-Plugin ab Version 4.3.0.
- Suchkomponente com_search: Sie gibt es in Joomla 5 nicht mehr und muss vor dem Update samt zugehöriger Module deinstalliert werden. Nutzen Sie künftig die Smart Search. Testen Sie diese am besten in der Testumgebung, bevor Sie die alte Suche entfernen.
- Schema.org: Joomla 5 behandelt strukturierte Daten dynamischer. Die Standardwerte entsprechen Joomla 4, für eigene Angaben bearbeiten Sie nach dem Update das Plugin „System – Schema.org“ (siehe Schritt 9).
Schritt 3: Testumgebung einrichten
Kopieren Sie die Website mit allen Dateien und der Datenbank auf eine Subdomain oder einen lokalen Server und prüfen Sie, dass die Kopie funktioniert. Joomla empfiehlt ausdrücklich einen Testlauf vor dem Update der echten Website und rät, die dabei nötigen Schritte genau mitzuschreiben.
Schalten Sie in der Testkopie die Fehlersuche ein: System → Globale Konfiguration → Reiter „System“ → Debug-System: Ja. Dann zeigt Joomla bei Problemen, welche Erweiterung sie verursacht.
Schritt 4: Testlauf durchführen
Gehen Sie in der Testkopie alle folgenden Schritte (5 bis 9) einmal komplett durch. Kommt es zu Fehlern:
- Deaktivieren Sie die Erweiterung, die den Fehler meldet, und notieren Sie sie.
- Fragen Sie beim Hersteller nach einer Joomla-5-Version oder suchen Sie Ersatz.
- Wiederholen Sie den Testlauf, bis das Ergebnis fehlerfrei ist.
Erst dann beginnen Sie mit der echten Website.
Schritt 5: Website vorbereiten
- Erstellen Sie zuerst ein komplettes Backup (siehe Schritt 6).
- Aktualisieren Sie unter System → Update Joomla auf die letzte 4.4.x-Version sowie alle Erweiterungen und das Template.
- Deaktivieren oder deinstallieren Sie Erweiterungen, die für Joomla 5 nicht geeignet sind.
- Deinstallieren Sie die alte Suchkomponente com_search und ihre Module, falls vorhanden.
- Ersetzen Sie Google reCAPTCHA durch Invisible reCAPTCHA oder eine andere Lösung, falls Sie es nutzen.
- Beschränken Sie im Plugin System – Debug unter „Erlaubte Gruppen“ die Debug-Ausgabe auf Super User. Schalten Sie danach die Fehlersuche ein: System → Globale Konfiguration → Reiter „System“ → Debug-System: Ja.
Schritt 6: Backup erstellen und testen
Erstellen Sie ein komplettes Backup (Dateien und Datenbank) wie auf der Übersichtsseite der Anleitungen im Abschnitt „Ganz wichtig: das Backup“ beschrieben, und zwar am besten zweimal: einmal vor Schritt 5 und einmal direkt vor dem Update. Prüfen Sie außerdem, dass sich das Backup tatsächlich wiederherstellen lässt. Ein Backup, das Sie nie getestet haben, ist keine Sicherheit.
Schritt 7: Update-Kanal umstellen und Vorabprüfung ansehen
- Öffnen Sie System → Update → Joomla.
- Klicken Sie oben auf Optionen.
- Stellen Sie den Update-Kanal auf „Joomla Next“. Ohne diese Einstellung zeigt Joomla das Update auf die neue Hauptversion nicht an.
- Klicken Sie auf Speichern & Schließen.
Wenn Ihr Server die Anforderungen erfüllt, sehen Sie nun die Vorabprüfung mit den Bereichen „Erforderliche Einstellungen“, „Empfohlene Einstellungen“ und „Erweiterungen“.
Wichtig: Die Erweiterungsprüfung ist nur ein grober Überblick. Ob eine Erweiterung wirklich kompatibel ist, hängt davon ab, ob der Hersteller die richtigen Angaben hinterlegt hat. Verlassen Sie sich auf Ihren Testlauf. Ein fehlendes grünes Häkchen bei den Erweiterungen bedeutet also nicht zwingend ein Problem, ein grünes Häkchen aber auch keine Garantie.
Schritt 8: Das Update starten
- Setzen Sie das Häkchen, mit dem Sie die Warnung vor möglicherweise inkompatiblen Erweiterungen bestätigen, und klicken Sie im Hinweisfenster auf OK.
- Klicken Sie auf Update.
- Bestätigen Sie auf der nächsten Seite, dass Sie ein Backup erstellt haben.
- Warten Sie, bis die Erfolgsmeldung erscheint. Unterbrechen Sie den Vorgang nicht.
Nach dem Update zeigt die Administration oben rechts die Version Joomla 5. Das Kompatibilitäts-Plugin „Behaviour – Backward Compatibility“ ist dabei automatisch aktiviert worden.
Schritt 9: Nach dem Update prüfen
- Frontend testen: Startseite, Menüs, Beiträge, Formulare, Suche, Anmeldung, Mehrsprachigkeit, Bilder und Downloads.
- Backend testen: Beiträge bearbeiten, Menüs und Module öffnen, Erweiterungen aufrufen.
- Datenbankstruktur prüfen: Unter System → Wartung → Datenbank zeigt Joomla Abweichungen an. Gibt es welche, markieren Sie sie und klicken auf „Struktur aktualisieren“.
- Suchindex prüfen: Joomla weist darauf hin, die Smart Search (Suchindex) nach dem Update bei Bedarf zu überarbeiten. Bauen Sie den Index gegebenenfalls neu auf.
- Schema.org einrichten: Öffnen Sie System → Verwalten → Plugins, suchen Sie das Plugin „System – Schema.org“ und tragen Sie Ihre Website-Angaben ein.
- Debug ausschalten: System → Globale Konfiguration → Reiter „System“ → Debug-System: Nein.
- Update-Kanal zurückstellen: Setzen Sie den Kanal unter System → Update → Joomla → Optionen wieder auf „Standard“, damit künftig keine Hauptversionssprünge angeboten werden. Das ist eine Empfehlung, kein Pflichtschritt.
Das Kompatibilitäts-Plugin prüfen
Ob Sie das Plugin „Behaviour – Backward Compatibility“ später deaktivieren können, zeigt nur ein Test: Läuft jede Erweiterung ohne dieses Plugin, ist es entbehrlich. Joomla rät dazu, das zuerst in einer Testumgebung zu prüfen. Im Notfall lässt sich das Plugin direkt in der Datenbank wieder einschalten: In der Tabelle #__extensions heißt der Eintrag plg_behaviour_compat, das Feld enabled steht auf 1 (aktiv) oder 0 (deaktiviert). Beachten Sie den Tabellenpräfix Ihrer Installation und halten Sie den Datenbankzugang bereit.
Wie geht es weiter?
Aktualisieren Sie Joomla anschließend auf die letzte Version von 5.4. Von dort führt der Weg auf Joomla 6, siehe Joomla 5.x nach 6.x. Planen Sie diesen Schritt zeitnah, denn Joomla 5 ist nur eine Zwischenstation.
Wenn etwas schiefgeht
Dank eingeschaltetem Debug erkennen Sie meist, welche Erweiterung das Problem verursacht, und können sie deaktivieren. Ist der Administrationsbereich nicht mehr erreichbar, deaktivieren Sie die Erweiterung direkt in der Datenbank: In der Tabelle #__extensions steht dafür das Feld enabled (1 = aktiv, 0 = deaktiviert), ein Erweiterungspaket kann mehrere Einträge haben. Melden Sie sich anschließend im Backend an und deinstallieren Sie die Erweiterung unter System → Verwalten → Erweiterungen. 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.
