Was der Wartungsmodus bedeutet

Der Wartungsmodus ist ein Schutzzustand. Nextcloud schaltet ihn selbsttätig ein, bevor ein Update eingespielt wird: Die Datenbank und die Dateien dürfen während der Umbauphase nicht gleichzeitig von Benutzern verändert werden, also sperrt die Software die Oberfläche für alle ab. Nach erfolgreichem Update wird der Modus automatisch wieder ausgeschaltet.

Der Wartungsmodus ist also kein Fehler, sondern ein Sicherheitsmechanismus. Zum Problem wird er erst, wenn er sich nicht wieder verabschiedet.

Warum er hängen bleiben kann

Die häufigsten Ursachen in der Praxis:

1. Das Update wurde abgebrochen – etwa weil der Browser geschlossen, die Verbindung getrennt oder der Server während des Updates neu gestartet wurde.
2. Ein PHP-Limit wurde erreicht: die maximale Ausführungszeit oder der verfügbare Speicher des Skripts reichte für das Update nicht aus.
3. Ein App-Konflikt: eine installierte App ist mit der neuen Version nicht kompatibel und bricht den Upgrade-Prozess ab.
4. Ein Datenbank-Fehler während der Migration, etwa ein Timeout bei großen Tabellen.
5. Der Wartungsmodus wurde manuell aktiviert – für Backups oder Wartungsarbeiten – und nie wieder ausgeschaltet.

Was Sie auf keinen Fall tun sollten

Zunächst die wichtigste Regel: Schalten Sie den Server nicht einfach aus und wieder ein. Ein Neustart mitten in einer halbfertigen Datenbank-Migration kann die Installation beschädigen – aus dem vorübergehenden Stillstand wird dann ein echter Datenverlust. Das gleiche gilt für das Löschen von Ordnern oder das „Zurücksetzen“ per Dateiaustausch.

Zweitens: Deaktivieren Sie den Wartungsmodus nicht vorschnell per Konfiguration, solange unklar ist, ob das Update noch läuft. Der Schalter steht in der Datei config/config.php – der Eintrag ‚maintenance‘ => true. Wer ihn auf false setzt, während die Datenbank-Migration noch arbeitet, riskiert inkonsistente Daten. Erst verstehen, dann handeln.

Die Schritt-für-Schritt-Analyse

Schritt 1: Läuft das Update noch?

Prüfen Sie, ob der Upgrade-Prozess noch arbeitet. Auf der Kommandozeile des Servers zeigt der Befehl:

sudo -u www-data php occ status

Das Ergebnis sagt Ihnen, ob eine Installation oder ein Upgrade aktiv ist, welche Version vorliegt und ob der Wartungsmodus an steht. Läuft der Prozess noch: abwarten. Große Installationen brauchen für ein Update durchaus 30 Minuten und mehr.

Schritt 2: Logs prüfen

Die Datei nextcloud.log im Datenverzeichnis und das Server-Error-Log zeigen, ob und wo der Prozess abgebrochen ist. Typische Einträge: abgebrochene Datenbank-Migrationen, Memory-Limit-Fehler oder abbrechende Apps.

Schritt 3: Update fortsetzen

Ist das Update abgebrochen, lässt es sich in der Regel fortsetzen:

sudo -u www-data php occ upgrade

Der Befehl nimmt die unterbrochene Migration dort wieder auf, wo sie stehengeblieben ist. Scheitert er an der Ausführungszeit, hilft es, die PHP-Limits für den Lauf anzuheben – etwa per Kommandozeilen-Aufruf mit angepassten Werten.

Schritt 4: Störende App deaktivieren

Bricht das Upgrade an einer bestimmten App, lässt sich diese vorübergehend deaktivieren:

sudo -u www-data php occ app:disable name-der-app

Danach wird occ upgrade erneut ausgeführt. Die deaktivierte App wird nach einem kompatiblen Update wieder aktiviert.

Schritt 5: Wartungsmodus lösen

Ist das Update sauber durchgelaufen, sichert derocc-Befehl den Zustand:

sudo -u www-data php occ maintenance:mode –off

Erst jetzt – nach erfolgreichem Abschluss – ist das der richtige Weg. Der Eintrag in der config.php wird dadurch korrekt zurückgesetzt.

Schritt 6: Backup vor jedem manuellen Eingriff

Bevor Sie an Konfiguration oder Datenbank manuell herantreten: Sichern Sie den Datenstand. Ein Fehler in der Handarbeit ist schneller gemacht als wieder gutgemacht.