Wo finde ich den Pre-Update-Check?
Im Joomla-Backend: System → Update → Joomla. Bei Major-Sprüngen muss vorher der Update-Channel umgestellt werden:
- Klick auf Optionen (oben rechts)
- Update-Channel von „Default" auf „Joomla Next" umstellen
- Speichern
Erst danach zeigt der Pre-Update-Check den Sprung auf die nächste Major-Version an. Wenn er stattdessen ein „Sie sind aktuell"-Anzeige liefert, ist der Channel noch falsch konfiguriert.
Die drei Bereiche im Detail
Bereich 1: Required Settings (Pflicht)
Server-Voraussetzungen, die für die neue Joomla-Version mindestens erfüllt sein müssen. Die wichtigsten:
- PHP-Version5.x: PHP 8.1+, 6.x: PHP 8.2+. Bei alten Hostings oft nicht erfüllt.
- MySQL-VersionJoomla 5/6: MySQL 8.0.13+ oder MariaDB 10.4+.
- Apache mod_rewriteaktiv (für saubere URLs).
- Maximale Datei-Upload-Größetypischerweise mindestens 10 MB.
- open_basedir-EinschränkungenJoomla braucht Lese/Schreib-Zugriff auf bestimmte Verzeichnisse.
- PHP-Extensionsmbstring, mysqli, zip, openssl, dom, xml, json, simplexml.
Wenn hier was rot ist, geht es nicht weiter. Hosting-Anbieter kontaktieren oder Konfiguration anpassen.
Bereich 2: Recommended Settings (Empfehlung)
Empfohlene Server-Konfiguration. Gelb ist akzeptabel, rot heißt: nachbessern, bevor das Update startet.
- PHP-Limitsmemory_limit (256 MB+), max_execution_time (120 s+), upload_max_filesize (64 MB+).
- OPcache aktivfür bessere Performance.
- Send PHP Version on the headers ausschalten(
expose_php = Off) – Sicherheit. - display_errors auf Off in Produktion– Sicherheit.
- SSL aktivHTTPS-Pflicht für ernsthafte Sites.
Bereich 3: Extensions (kritisch)
Hier prüft Joomla, ob jede installierte Erweiterung mit der Ziel-Version kompatibel ist. Drei mögliche Status:
- Grün – kompatibelExtension hat eine offizielle Version für die Ziel-Joomla-Version.
- Gelb – evtl. inkompatibelExtension-Hersteller hat keine eindeutige Auskunft. Test im Subdomain-Klon zeigt, ob sie mit Backward-Compatibility-Plugin trotzdem läuft.
- Rot – inkompatibelExtension wird in der Ziel-Version definitiv nicht laufen. Vor dem Update muss sie aktualisiert, getauscht oder deaktiviert werden.
Wichtiger Hinweis: der Joomla-eigene Extension-Check basiert auf den Manifest-Angaben der Extension-Hersteller. Manche pflegen diese Angaben nicht, sodass kompatible Extensions als gelb angezeigt werden, oder umgekehrt inkompatible als grün. Im Zweifelsfall: das Joomla Extensions Directory (JED) gibt das verlässlichere Bild – dort gibt es ab Joomla 4 ein offizielles Kompatibilitäts-Badge.
Typische Stolperfallen
Falle 1: PHP-Version-Konflikt
Häufigster roter Befund. Hosting läuft noch auf PHP 7.4 oder 8.0, Joomla 5 verlangt 8.1+. Lösung: Hosting-Backend prüfen, ob PHP-Switch möglich ist (Plesk, cPanel, ISPConfig haben das meist), sonst Hoster-Support kontaktieren.
Falle 2: open_basedir blockiert Update-Vorgang
Das Update lädt das Update-Paket herunter und entpackt es in temporäre Verzeichnisse. Wenn open_basedir das blockiert, scheitert das Update mit kryptischen Fehlermeldungen. Lösung: Upload-Update statt Live-Update verwenden, oder beim Hoster open_basedir temporär lockern.
Falle 3: max_execution_time zu kurz
Bei größeren Sites mit vielen Extensions kann das Update länger dauern als die Standard-30-Sekunden-Execution-Time. Dann bricht der Update-Vorgang ab. Lösung: vorher auf 120 oder 300 Sekunden erhöhen.
Falle 4: memory_limit erschöpft
Bei großen Datenbanken kann das Update PHP-Memory aufbrauchen. Symptom: Update startet, bleibt mitten drin stehen, weißer Bildschirm. Lösung: memory_limit auf 256 MB oder 512 MB hochsetzen.
Falle 5: gelb angezeigte Extensions sind tatsächlich rot
Ältere Extensions, die im Manifest noch „compatibility: 4.x" stehen haben, werden als gelb angezeigt – funktionieren in Joomla 5 aber nicht. Lösung: Subdomain-Test-Update vor dem Live-Update macht solche Probleme sichtbar.
Falle 6: com_search ist installiert
Die alte Suche wurde in Joomla 5 entfernt. Wenn deine Site noch com_search nutzt, muss vor dem Update auf Smart Search (com_finder) umgestellt werden. Smart Search ist seit Joomla 3 dabei, hat aber andere Konfiguration.
Falle 7: Google reCAPTCHA durch Invisible reCAPTCHA tauschen
Das normale reCAPTCHA-Plugin ist in Joomla 5 entfernt. Wer es noch in Kontakt-Formularen oder Login-Hardening nutzt, muss auf Invisible reCAPTCHA oder eine andere Lösung umstellen.
Checkliste vor dem Live-Update
- Alle „Required Settings" grün?
- Mindestens 90 % der „Recommended Settings" grün, der Rest gelb?
- Alle Extensions grün, oder im Subdomain-Test verifiziert lauffähig?
- com_search bei Bedarf entfernt und Smart Search aktiv?
- Google reCAPTCHA bei Bedarf durch Invisible reCAPTCHA ersetzt?
- Verifiziertes vollständiges Backup vorhanden?
- Subdomain-Test-Update durchgeführt (bei Major-Sprüngen)?
Erst wenn diese sieben Punkte erfüllt sind, geht das Live-Update wirklich sauber durch. Den Subdomain-Test überspringen sollte man nur bei trivialen Minor-Updates – bei jedem Major-Sprung lohnt er sich.