Was vor dem Update steht: Update-Typ klären
Minor-Update (z. B. 5.4.4 → 5.4.5)
Routine-Sache. Seit Joomla 5.4 / 6.0 (Oktober 2025) sogar automatisch möglich. Der Backup-Aufwand ist minimal, das Risiko gering – Minor-Updates ändern keine APIs, sondern fixen Bugs und schließen Sicherheitslücken.
Major-Update innerhalb der Joomla-4+-Ära (4.4 → 5.x oder 5.4 → 6.x)
Größerer Sprung, aber kein Re-Install: das ist seit Joomla 4 ein Routine-Upgrade mit Backward-Compatibility-Plugin. Wichtig: nur von der jeweiligen LTS-Version aus möglich.
- Joomla 4 → 5: nur von 4.4.x aus, nicht von älteren 4er-Versionen
- Joomla 5 → 6: nur von 5.4.x aus, nicht von 5.0–5.3
Wenn du auf einer älteren Minor-Version steckst, geht der Pfad erst auf die passende LTS-Version (5.4 bzw. 4.4), dann auf den nächsten Major.
Migration aus Joomla 3 oder älter
Echte Migration mit Re-Install und Daten-Übernahme. Ein direkter Sprung von 3 auf 5/6 ist nicht möglich – der Pfad ist Joomla 3 → 4.4 → 5.4 → ggf. 6.x. Sonderbehandlung erforderlich, Details: Joomla 3 → 5/6.
Schritt 1: Pre-Update-Check
Joomla bringt einen eigenen Pre-Update-Check mit (System → Update → Joomla), der bei Major-Sprüngen drei Bereiche prüft:
- Required SettingsServer-Voraussetzungen wie PHP-Version, MySQL/MariaDB-Version, Apache-Module. Wenn hier was rot ist, geht es ohne Hosting-Anpassung nicht weiter.
- Recommended SettingsEmpfohlene Werte (PHP-Limits, OPcache, etc.). Gelb ist akzeptabel, rot heißt: nachbessern.
- ExtensionsJede installierte Erweiterung wird auf Joomla-Kompatibilität geprüft. Inkompatible Extensions müssen vor dem Update aktualisiert, getauscht oder deaktiviert werden.
Detaillierte Anleitung mit Checkliste: Pre-Update-Check.
Schritt 2: Vollständiges Backup
Vor jedem ernsthaften Update – speziell bei Major-Sprüngen – ein verifiziertes Backup:
- Akeeba Backup (kostenlos in der Core-Version)Komplettes Site-Backup als JPA oder ZIP-Archiv inkl. Datenbank.
- Hosting-Panel-BackupBei vielen Hostern (Plesk, cPanel) als 1-Klick-Lösung verfügbar.
- Manuelles BackupFTP-Download des kompletten Webroots plus Datenbank-Export per phpMyAdmin oder mysqldump.
Wichtig: Test-Restore. Backup ist nur dann ein Backup, wenn auch die Wiederherstellung funktioniert. Wir testen Backups vor jedem Major-Update auf einer Subdomain – das Backup, das im Ernstfall nicht zurückkommt, ist nicht hilfreich.
Schritt 3: Backward-Compatibility-Plugin aktivieren
Für Major-Sprünge: System → Verwalten → Plugins → „Behaviour - Backward Compatibility" aktivieren. Bei einem Update von 4.4 auf 5 wird das automatisch eingeschaltet, bei 5.4 auf 6 muss man das gegebenenfalls manuell prüfen.
Das Plugin hält ältere Klassen und APIs am Leben, sodass Extensions, die auf Joomla 4 entwickelt wurden, auch in Joomla 5 oder 6 weiterlaufen. Längerfristig sollten Extension-Entwickler ihre Pakete aber auf moderne APIs umstellen – und das Plugin irgendwann deaktiviert werden können.
Schritt 4: Update durchführen
Variante A: Live-Update über Joomla-Backend
- Im Backend: System → Update → Joomla
- Bei Major-Sprung: Optionen → Update-Channel auf „Joomla Next" stellen, speichern
- Pre-Update-Check noch einmal anschauen, dann Install the Update
- Wartezeit je nach Site-Größe: 1–5 Minuten
Variante B: Upload-Update
Bei Hostern, deren Server keine direkten Update-Downloads zulassen, oder wenn der Live-Update fehlschlägt:
- Update-Paket von downloads.joomla.org herunterladen
- Im Backend: System → Update → Joomla → Upload & Update
- ZIP-Datei hochladen, Joomla extrahiert und installiert
Variante C: Plesk Site-Tools (bei Plesk-Hosting)
Bei Plesk-Servern lassen sich Joomla-Updates über das Plesk-Backend anstoßen: Domains → Site Tools → Updates and Upgrades. Das ist bequem, aber nutzt nicht den Pre-Update-Check, weshalb wir bei Major-Sprüngen das Joomla-eigene Update bevorzugen.
Schritt 5: Datenbank und Cache
Nach jedem Major-Update zwei Pflicht-Schritte:
- System → Datenbank → FixKorrigiert Tabellen-Strukturen, falls eine Datenbank-Änderung beim Update nicht sauber durchgelaufen ist.
- System → Site-Wartung → Cache leerenKomponente-Cache und Smart-Search-Cache.
Schritt 6: Funktions-Test
Stichprobenartig durch die Site:
- FrontendStartseite, 2–3 Unterseiten, Menüs, Suchfunktion (mittlerweile Smart Search), Kontakt-Formular.
- BackendLogin, Inhaltspflege, Plugin-Konfiguration, Modul-Veröffentlichung.
- TemplatesVerzerrt nichts, kein Layout-Bruch, mobile Ansicht ok.
- Spezial-FunktionenShop-Cart bei VirtueMart/Hikashop, Mitglieder-Login bei Membership-Sites, Mehrsprachigkeit.
Wenn etwas nicht klappt: Troubleshooting
Update bricht mit Memory-Fehler ab
PHP-memory_limit auf mindestens 256 MB hochsetzen.
Bei Bedarf max_execution_time auf 120 s.
500-Fehler nach dem Update
Häufig durch eine inkompatible Extension. Reihenfolge:
- Debug aktivieren:System → Globale Konfiguration → System → Debug System: Ja
- Templates per FTP umbenennenauf das Default-Template Cassiopeia ausweichen, falls das Theme das Problem ist
- Extensions deaktivierenper Datenbank: in der Tabelle
#__extensionseinzelne Extensions aufenabled = 0setzen - Wenn nichts hilft: Backup zurückspielen, Problem analysieren, neuen Versuch
Layout zerschossen nach Major-Update
Templates aus Joomla 3 sind oft nicht 4-kompatibel, Joomla-4-Templates oft nicht 5-kompatibel. Bei Major-Sprüngen kann ein Template-Wechsel notwendig sein – wir empfehlen vorher zu prüfen, ob der Template-Hersteller eine kompatible Version anbietet.
Extensions funktionieren teilweise nicht
Backward-Compatibility-Plugin aktiv? Wenn ja, weiterhin Probleme: Extension-Hersteller kontaktieren oder eine moderne Alternative finden. Für viele J3-Extensions gibt es seit dem Sprung auf 4 schon Nachfolger – die ist auf der Strecke geblieben, gehört zur Update-Aufräum-Arbeit.