// troubleshooting guide · nextcloud
Nextcloud Stuck in Maintenance Mode
- Status
- Workaround available
- platforms:
- Self-hosted
- updated:
- November 16, 2026
- reports:
- 3
- Method
- how we research
RUNBOOK · nextcloud/stuck-maintenance-mode3 FIXES
// quick answer
An interrupted update leaves Nextcloud in maintenance mode. Turn it off with occ and rerun occ upgrade.
Most likely fix: Disable maintenance mode with occ
How to fix it
// try these in order, the most common fix is first
FIX 1Disable maintenance mode with occ
- 01Run: sudo -u www-data php occ maintenance:mode --off
- 02Run: sudo -u www-data php occ upgrade
- 03Check the nextcloud.log for the failing app
Did this fix it?FIX 2Edit config.php
- 01If occ hangs, set 'maintenance' => false in config/config.php
- 02Then run occ upgrade
Did this fix it?FIX 3Use the CLI updater next time
- 01Back up first
- 02Use occ upgrade rather than the web updater for big instances
Did this fix it?
Symptoms
The page says 'This Nextcloud instance is currently in maintenance mode' long after an update.
Why it happens
- C-01Update or app upgrade interrupted
- C-02Timeouts in the web updater
- C-03A failing app during upgrade
// this guide also covers
- nextcloud maintenance mode stuck
- nextcloud update stuck maintenance mode
Still not working?
If Nextcloud keeps failing, you're not alone. See every Nextcloud problem users report or the alternatives people switch to.
Have an app idea? Our small team builds any software: web and mobile apps, games, desktop, AI tools. Price agreed together.
Talk to usOther Nextcloud errors
- Nextcloud Access Through Untrusted Domain Error
- Why Is Nextcloud So Slow?
- Nextcloud Upload Size Limit and 413 Error
- Nextcloud Desktop Client Sync Slow
- Nextcloud Sync Error: Connection Closed
- Nextcloud File Is Locked (423) Error
- Nextcloud Internal Server Error After Update or App Install
- Nextcloud Client CSync Unknown Error