Joomla 5.x nach 6.x migrieren

Der Schritt von Joomla 5 auf Joomla 6 ist die letzte Etappe auf dem Weg zur aktuellen Version: 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 4.x? Dann gehen Sie zuerst die Anleitung Joomla 4.x nach 5.x durch.

Das Wichtigste in Kürze

• Die Website muss auf der letzten Version von Joomla 5.4 laufen.
• Der Server braucht PHP 8.3 oder neuer und eine passende Datenbankversion.
• Das Plugin „Behaviour – Backward Compatibility“ (ohne Zahl im Namen) muss deaktiviert sein.
• Alle Erweiterungen und das Template müssen mit Joomla 6 laufen.
• 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 5.4.x sein. Läuft Ihre Website auf einer älteren Version, aktualisieren Sie zuerst auf 5.4.x.
• PHP-Version und Datenbank: Joomla 6 benötigt mindestens PHP 8.3, MySQL 8.0.13, MariaDB 10.6 oder PostgreSQL 14. Erfüllt der Server diese Anforderungen nicht, erscheint die Update-Möglichkeit in der Joomla-Aktualisierung gar nicht.

Ist PHP zu alt, lässt sich die Version meist im Verwaltungsbereich Ihres Hosters umstellen. Andernfalls hilft der Support des Hosters. Prüfen Sie nach der Umstellung, ob Ihre Website unter PHP 8.3 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 6 läuft. Dafür gibt es drei Wege:

1. Herstellerseite: Dort steht, ob und ab welcher Version die Erweiterung für Joomla 6 freigegeben ist.
2. Joomla Extensions Directory (JED): Dort zeigen Erweiterungen eine Kennzeichnung für Joomla-6-Kompatibilität, mit oder ohne das Kompatibilitäts-Plugin.
3. 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 6, 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.

Die beiden Kompatibilitäts-Plugins

In Joomla 5.4 gibt es zwei Plugins mit ähnlichem Namen (Suche unter System → Verwalten → Plugins nach „Backward“):

• Behaviour – Backward Compatibility: Es kam mit Joomla 5.0 und hält ältere Erweiterungen für Joomla 4 lauffähig. Vor dem Update auf Joomla 6 muss es deaktiviert sein.
• Behaviour – Backward Compatibility 6: Es kommt mit Joomla 5.4 und hilft Erweiterungen, unter Joomla 6 zu laufen. Es wird beim Update auf 5.4 automatisch aktiviert.

Ob Ihre Website ohne das erste Plugin läuft, müssen Sie vorher ausprobieren (siehe Schritt 4).

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 10) 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-6-Version oder suchen Sie Ersatz.
• Wiederholen Sie den Testlauf, bis das Ergebnis fehlerfrei ist.

Erst dann beginnen Sie mit der echten Website.

Schritt 5: Joomla und Erweiterungen aktualisieren

Erstellen Sie zuerst ein komplettes Backup (siehe Schritt 6). Aktualisieren Sie danach unter System → Update Joomla auf die letzte 5.4.x-Version sowie alle Erweiterungen und das Template. Erweiterungen, die für Joomla 6 nicht geeignet sind, deaktivieren oder deinstallieren Sie vorher.

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: Das alte Kompatibilitäts-Plugin deaktivieren

Deaktivieren Sie unter System → Verwalten → Plugins das Plugin „Behaviour – Backward Compatibility“ (das ohne die Zahl 6). Das ist Pflicht für das Update auf Joomla 6. Prüfen Sie danach Frontend und Backend sowie sämtliche Funktionen Ihrer Erweiterungen. Testen Sie insbesondere Formulare, Speichervorgänge, Benutzerrechte und andere wichtige Abläufe. Erst wenn alle Funktionen zuverlässig arbeiten, können Sie davon ausgehen, dass Ihre Erweiterungen ohne das alte Kompatibilitäts-Plugin auskommen.

Vorsicht: Läuft eine Erweiterung nicht ohne das Plugin, kann der Administrationsbereich unzugänglich werden. Deshalb ist der Testlauf so wichtig. Im Notfall lassen sich Plugins und Erweiterungen direkt in der Datenbank ein- oder ausschalten: In der Tabelle #__extensions steht dafür das Feld enabled (1 = aktiv, 0 = deaktiviert). Beachten Sie den Tabellenpräfix Ihrer Installation. Halten Sie den Datenbankzugang bereit.

Schritt 8: Update-Kanal umstellen und Vorabprüfung ansehen

1. Öffnen Sie System → Update → Joomla.
2. Klicken Sie oben auf Optionen.
3. Stellen Sie den Update-Kanal auf „Joomla Next“. Ohne diese Einstellung zeigt Joomla das Update auf die neue Hauptversion nicht an.
4. 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 9: Das Update starten

1. Setzen Sie das Häkchen, mit dem Sie die Warnung vor möglicherweise inkompatiblen Erweiterungen bestätigen, und klicken Sie im Hinweisfenster auf OK.
2. Klicken Sie auf Update.
3. Bestätigen Sie auf der nächsten Seite, dass Sie ein Backup erstellt haben.
4. Warten Sie, bis die Erfolgsmeldung erscheint. Unterbrechen Sie den Vorgang nicht.

Nach dem Update zeigt die Administration oben rechts die Version Joomla 6.

Schritt 10: 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.
• 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 Plugin „Backward Compatibility 6“

Es bleibt nach dem Update aktiv und hält ältere Erweiterungen am Laufen. Ob Sie es 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. Das Plugin stellt keine dauerhafte Lösung für veraltete Erweiterungen dar. Mit Joomla 7 wird die Unterstützung für Joomla-5-Erweiterungen über dieses Kompatibilitäts-Plugin entfallen. Aktualisieren oder ersetzen Sie solche Erweiterungen deshalb rechtzeitig.

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 wie oben beschrieben direkt in der Datenbank, melden Sie sich im Backend an und deinstallieren Sie sie 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.

Zur Migrationsanfrage

Alle Anleitungen im Überblick