So sieht die Meldung aus
Nextcloud or one of the apps require upgrade - only a limited number of operations are allowed
Updates between multiple major versions and downgrades are unsupported.
Update failedHäufige Ursachen
- Du hast versucht, eine Hauptversion zu überspringen, z. B. von Version N direkt auf N+2.
- Der Code ist älter als die Daten: Ein Datei-Backup oder ein alter Docker-Image-Tag wurde zurückgespielt, Datenbank und
config.phpgehören aber zu einer neueren Version. - Es ist der falsche Code-Ordner aktiv, z. B. zeigt ein Symlink oder das Web-Root nach einem Update noch auf eine alte Kopie.
- Ein Update wurde mittendrin unterbrochen, Code und Datenbank passen jetzt nicht mehr zusammen.
Prüfen
- Version des Codes auf der Platte
grep OC_VersionString /var/www/nextcloud/version.php - Version, die Nextcloud gespeichert hat
grep "'version'" /var/www/nextcloud/config/config.php - Was sagt die Kommandozeile?
- Wohin zeigt das Web-Root?
readlink -f /var/www/nextcloud
Lösung
- Die beiden Versionen vergleichen. Ist der Code älter als die gespeicherte Version, den passenden neueren Code zurücklegen oder ein Datenbank-Backup zurückspielen, das zusammen mit diesem Code entstand.
- Wenn du eine Hauptversion übersprungen hast, zuerst das letzte Release der nächsten Hauptversion installieren,
sudo -u www-data php occ upgradeausführen und das Schritt für Schritt wiederholen, bis du das Ziel erreichst. - Vor jedem Schritt Code,
config.php, Daten und Datenbank sichern und Apps, die die nächste Version nicht unterstützen, mitocc app:disabledeaktivieren. 'version'in derconfig.phpnicht ändern, um die Prüfung zu umgehen. Das kann das Datenbankschema beschädigen.- Nach dem letzten Schritt den Wartungsmodus mit
occ maintenance:mode --offverlassen und die Admin-Übersicht prüfen.
Typisches Szenario
Ein Docker-Setup nutzt image: nextcloud:latest. Nach monatelangem Stillstand führt docker compose pull zwei Hauptversionen auf einmal nach vorn, und der Container bricht beim Start mit Updates between multiple major versions and downgrades are unsupported ab. Die Daten sind unverändert, nur der Code ist zu neu für den Stand in config.php. Zuerst prüfen: Welche Version steht in config.php, welche liefert das Image?
Häufige Fragen
Kann ich Nextcloud downgraden?
Nicht durch Austauschen des Codes. Ein Downgrade ist nur sicher, indem du ein vollständiges Backup (Code, Konfiguration und Datenbank) vom selben Zeitpunkt zurückspielst.
Woher weiß ich, welche Hauptversionen ich installieren muss?
Lies die Release Notes und den Update-Pfad der offiziellen Dokumentation für deine Ausgangsversion und gehe jede Hauptversion der Reihe nach durch, jeweils mit dem neuesten Minor-Release.
Warum sollte ich in Docker nicht auf latest setzen?
Mit latest bestimmt der Zeitpunkt des Pulls die Version, und mehrere Hauptversionen können sich ansammeln. Nutze ein festes Tag wie nextcloud:28 und erhöhe es bewusst um eine Hauptversion pro Schritt, jeweils mit abgeschlossenem Update dazwischen.
Darf ich Patch- und Minor-Versionen überspringen?
Innerhalb derselben Hauptversion ja, du kannst direkt auf das aktuelle Release dieser Linie springen. Verboten ist nur das Überspringen ganzer Hauptversionen. Der Weg von 26 nach 28 führt also über die letzte 27er-Version.
Was tun, wenn das zu neue Image schon gestartet wurde?
Stoppe es und setze wieder das Image, das zur Version in config.php passt, oder die nächsthöhere Hauptversion. Ein Downgrade ist nicht vorgesehen. Wurde die Datenbank bereits teilweise umgestellt, hilft nur das Zurückspielen eines Backups von Datenbank und Konfiguration.