// 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
Share

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

  1. FIX 1Finish the upgrade with occ

    1. 01cd to the ownCloud directory (e.g. /var/www/owncloud)
    2. 02Run: sudo -u www-data php occ upgrade
    3. 03Then: sudo -u www-data php occ maintenance:mode --off
    Did this fix it?
  2. FIX 2Turn maintenance off first if occ complains

    1. 01If occ upgrade says no apps have been loaded, run occ maintenance:mode --off first
    2. 02Run occ upgrade again
    Did this fix it?
  3. FIX 3Disable the failing app

    1. 01Read data/owncloud.log for the app that failed
    2. 02Run occ app:disable <app>
    3. 03Run occ upgrade, then re-enable or update the app
    Did this fix it?
  4. FIX 4Check config.php

    1. 01Make sure 'maintenance' => false in config/config.php
    2. 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 us

Watch ownCloud Get an email when its price changes, it has an outage, or we publish a new fix. No spam.

Fixed it? Share this guide

Other ownCloud errors

All 12 ownCloud errors and fixes →