// troubleshooting guide · nextcloud

Nextcloud Stuck in Maintenance Mode

Status
Workaround available
platforms:
Self-hosted
updated:
November 16, 2026
reports:
3
Method
how we research
Share

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

  1. FIX 1Disable maintenance mode with occ

    1. 01Run: sudo -u www-data php occ maintenance:mode --off
    2. 02Run: sudo -u www-data php occ upgrade
    3. 03Check the nextcloud.log for the failing app
    Did this fix it?
  2. FIX 2Edit config.php

    1. 01If occ hangs, set 'maintenance' => false in config/config.php
    2. 02Then run occ upgrade
    Did this fix it?
  3. FIX 3Use the CLI updater next time

    1. 01Back up first
    2. 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 us

Watch Nextcloud 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 Nextcloud errors

All 10 Nextcloud errors and fixes →