// troubleshooting guide · owncloud
ownCloud Stuck in Maintenance Mode After Update
- Status
- Workaround available
- platforms:
- Self-hosted ownCloud Classic
- updated:
- November 16, 2026
- reports:
- 4
- Method
- how we research
RUNBOOK · owncloud/stuck-in-maintenance-mode4 FIXES
// quick answer
The update finished but the upgrade step didn't. Run occ upgrade as the web server user, then occ maintenance:mode --off, and check owncloud.log if it fails.
Most likely fix: Finish the upgrade with occ
How to fix it
// try these in order, the most common fix is first
FIX 1Finish the upgrade with occ
- 01cd to the ownCloud directory (e.g. /var/www/owncloud)
- 02Run: sudo -u www-data php occ upgrade
- 03Then: sudo -u www-data php occ maintenance:mode --off
Did this fix it?FIX 2Turn maintenance off first if occ complains
- 01If occ upgrade says no apps have been loaded, run occ maintenance:mode --off first
- 02Run occ upgrade again
Did this fix it?FIX 3Disable the failing app
- 01Read data/owncloud.log for the app that failed
- 02Run occ app:disable <app>
- 03Run occ upgrade, then re-enable or update the app
Did this fix it?FIX 4Check config.php
- 01Make sure 'maintenance' => false in config/config.php
- 02Restart PHP-FPM or Apache to clear caches
Did this fix it?
Symptoms
Every page shows 'This ownCloud instance is currently in maintenance mode' or asks for an update after a package or web update.
Why it happens
- C-01Package manager updated the code but didn't run the upgrade
- C-02Upgrade interrupted or timed out in the browser
- C-03An app couldn't be upgraded (e.g. marketplace unreachable)
- C-04occ run from the wrong directory or user
// this guide also covers
- owncloud maintenance mode
- owncloud stuck in maintenance mode
- owncloud maintenance mode off
- owncloud update stuck
Still not working?
If ownCloud keeps failing, you're not alone. See every ownCloud 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 ownCloud errors
- ownCloud Desktop Client Not Syncing
- ownCloud Desktop App 7 Not Connecting to ownCloud Server
- ownCloud File Is Locked (Server Replied 423 Locked)
- ownCloud Access Through Untrusted Domain Error
- ownCloud Large File Upload Fails (413 Request Entity Too Large)
- ownCloud Integrity Check Failed (Some Files Have Not Passed)
- ownCloud Unable to Open or Create the Local Sync Database
- ownCloud Virtual Files Not Working on Windows