Update Nextcloud unter docker (Update)

(Update 23-02-2026)

Das Update von nextcloud unter docker ist schnell erledigt, die Nacharbeiten auch. Wenn man weiß wie. Im ersten Schritt wird im Arbeitsverzeichnis der Container gestoppt, gelöscht, das Update gezogen und dann alles wieder neu gestartet.

Es gelten die allgemeinen Spielregeln:

Backup

Dabei sind die folgenden Ordner zu erfassen, wobei das immer gilt, im Speziellen aber das Update des Imgages (docker) nur peripher tangiert. Der Vollständigkeit halber aber sei darauf hingewiesen:

• config
• data
• theme
• database

Maintenance Mode

Ich betreibe meinen Server all alone, wer das aber in einem entsprechend größeren Kontext macht, der sollte die User vorwarnen. Das Replacement eines Images geht mit einem Ausfall einher und die Nacharbeiten nehmen auch ein paar Minuten in Anspruch.

docker exec --user www-data \
  php occ maintenance:mode --on

Wie die User von der Wartung erfahren ist eine Frage der Vorgaben. Ich mache das für mich, also weiß ich schlicht auch Bescheid.

cd /opt/containers/nextcloud
docker stop nextcloud-app
docker rm nextcloud-app
docker pull nextcloud

Wie Dein Container heißt kannst Du mit docker ps herausfinden. Meiner heißt nextcloud-app. IM Anschluss wird die neue Version gestartet

docker compose up -d

Das funktioniert eben nur im Arbeitsverzeichnis. Wenn dieser Schritt nicht passiert ist, dann hilft die ausführliche Version vielleicht weiter…

docker compose -f /opt/containers/nextcloud/docker-compose.yml up -d

Wenn Du Dich danach (genauer gesagt braucht nextcloud ca. 1 Minute bis es wieder gestartet ist), in der Web-GUI anmeldest findest Du in den Admineinstellungen in 99% der Fälle eine Meldung, dass irgendwas nicht passt. Mindestens, dass DB Indizes nicht erstellt sind. Das muss an der Kommandozeile nachgeholt werden.

Datenbank Indizes

Wer ein Update-Skript geschrieben hat, kann diesen Punkt auch dort eintragen.

docker exec --user www-data nextcloud-app \
  php occ db:add-missing-indices

Maintenance Window

Gerne auch dabei ist der Parameter maintenance_window_start. Die Erklärung dazu findest Du in der Admin Doku . Den Befehl zum Setzen:

docker exec --user www-data nextcloud-app \
  php occ config:system:set maintenance_window_start \
  --type=integer --value=1

Weitere Hifestellung gibt es in den aktuellen Admin Docs auf nextcloud.com