nextcloud/server · error · OCA\DAV\Exception\ServerMaintenanceMode

Upgrade needed

Error message

Upgrade needed

What it means

Error "Upgrade needed" thrown in nextcloud/server.

Source

Thrown at apps/dav/lib/Connector/Sabre/MaintenancePlugin.php:64

	 */
	#[\Override]
	public function initialize(\Sabre\DAV\Server $server) {
		$this->server = $server;
		$this->server->on('beforeMethod:*', [$this, 'checkMaintenanceMode'], 1);
	}

	/**
	 * This method is called before any HTTP method and returns http status code 503
	 * in case the system is in maintenance mode.
	 *
	 * @throws ServiceUnavailable
	 */
	public function checkMaintenanceMode(): bool {
		if ($this->config->getSystemValueBool('maintenance')) {
			throw new ServerMaintenanceMode($this->l10n->t('System is in maintenance mode.'));
		}
		if (Util::needUpgrade()) {
			throw new ServerMaintenanceMode($this->l10n->t('Upgrade needed'));
		}

		return true;
	}
}

View on GitHub (pinned to ecdeb153ff)

When it happens

Trigger: Thrown at apps/dav/lib/Connector/Sabre/MaintenancePlugin.php:64 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of nextcloud/server@ecdeb153ff (2026-08-17). Data as JSON: /api/errors/51ce33ed53cd1f3a. Report an issue: GitHub.