Nextcloud: Updates between multiple major versions and downgrades are unsupported

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 failed

Hä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.php gehö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

1. Version des Codes auf der Platte
   grep OC_VersionString /var/www/nextcloud/version.phpKopieren
2. Version, die Nextcloud gespeichert hat
   grep "'version'" /var/www/nextcloud/config/config.phpKopieren
3. Was sagt die Kommandozeile?
   sudo -u www-data php occ statusKopieren
4. Wohin zeigt das Web-Root?
   readlink -f /var/www/nextcloudKopieren

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 upgrade ausfü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, mit occ app:disable deaktivieren.
• 'version' in der config.php nicht ändern, um die Prüfung zu umgehen. Das kann das Datenbankschema beschädigen.
• Nach dem letzten Schritt den Wartungsmodus mit occ maintenance:mode --off verlassen und die Admin-Übersicht prüfen.

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.