Unable to find updater with NC 33

ℹ️ Support
, , , , ,
1
Support intro

Sorry to hear you’re facing problems. :slightly_frowning_face:

The community help forum (help.nextcloud.com) is for home and non-enterprise users. Support is provided by other community members on a best effort / “as available” basis. All of those responding are volunteering their time to help you.

If you’re using Nextcloud in a business/critical setting, paid and SLA-based support services can be accessed via portal.nextcloud.com where Nextcloud engineers can help ensure your business keeps running smoothly.

Getting help

In order to help you as efficiently (and quickly!) as possible, please fill in as much of the below requested information as you can.

Before clicking submit: Please check if your query is already addressed via the following resources:

(Utilizing these existing resources is typically faster. It also helps reduce the load on our generous volunteers while elevating the signal to noise ratio of the forums otherwise arising from the same queries being posted repeatedly).

Some or all of the below information will be requested if it isn’t supplied; for fastest response please provide as much as you can. :heart:

The Basics

  • Nextcloud Server version (e.g., 29.x.x):
    • 33
  • Operating system and version (e.g., Ubuntu 24.04):
    • Debian 11
  • Web server and version (e.g, Apache 2.4.25):
    • none
  • Reverse proxy and version _(e.g. nginx 1.27.2)
    • nginx 1.31.3
  • PHP version (e.g, 8.3):
    • 8.4.19
  • Is this the first time you’ve seen this error? (Yes / No):
    • yes
  • When did this problem seem to first start?
    • upgrade a plugin via GUI
  • Installation method (e.g. AlO, NCP, Bare Metal/Archive, etc.)
    • Docker
  • Are you using CloudfIare, mod_security, or similar? (Yes / No)
    • no

Summary of the issue you are facing:

Tried to upgrade a plugin in GUI mode, the application immediately displayed that it entered maintenance mode and was stuck in this state. I tried to flip the maintenance indicator with command line and now the application displays “use the web update at your own risk”.

Tried to switch to the documented built-in updater, but there isn’t any /var/www/nextcloud/updater/updater.phar file! Not even an updater folder…

How can enter the manual upgrade mode then?

Steps to replicate it (hint: details matter!):

Log entries

Nextcloud

Please provide the log entries from your Nextcloud log that are generated during the time of problem (via the Copy raw option from Administration settings->Logging screen or from your nextcloud.log located in your data directory). Feel free to use a pastebin/gist service if necessary.

172.18.0.4 - - [18/Sep/2026:14:01:00 +0000] "POST /ocs/v2.php/apps/spreed/api/v1/signaling/backend HTTP/1.1" 503 1579 "-" "nextcloud-spreed-signaling/2.1.0~docker"
109.89.189.58 - - [18/Sep/2026:14:01:06 +0000] "GET /ocs/v2.php/apps/notifications/api/v2/notifications HTTP/1.1" 503 821 "-" "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:155.0) Gecko/20100101 Firefox/155.0"
109.89.189.58 - - [18/Sep/2026:14:01:10 +0000] "PUT /ocs/v2.php/apps/user_status/api/v1/heartbeat?format=json HTTP/1.1" 503 821 "-" "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:155.0) Gecko/20100101 Firefox/155.0"
172.18.0.4 - - [18/Sep/2026:14:01:10 +0000] "POST /ocs/v2.php/apps/spreed/api/v1/signaling/backend HTTP/1.1" 503 1579 "-" "nextcloud-spreed-signaling/2.1.0~docker"
109.89.189.58 - pverrando [18/Sep/2026:14:01:11 +0000] "GET /ocs/v2.php/apps/spreed/api/v4/room?modifiedSince=0&includeStatus=true&includeLastMessage=true HTTP/1.1" 503 821 "-" "Mozilla/5.0 (Macintosh) Nextcloud-Talk v2.2.4"

Web Browser

If the problem is related to the Web interface, open your browser inspector Console and Network tabs while refreshing (reloading) and reproducing the problem. Provide any relevant output/errors here that appear.

PASTE

Web server / Reverse Proxy

The output of your Apache/nginx/system log in /var/log/____:

PASTE HERE

Configuration

Nextcloud

The output of occ config:list system or similar is best, but, if not possible, the contents of your config.php file from /path/to/nextcloud is fine (make sure to remove any identifiable information!):

<?php
$CONFIG = array (
  'serverid' => 1,
  'htaccess.RewriteBase' => '/',
  'memcache.local' => '\\OC\\Memcache\\APCu',
  'apps_paths' => 
  array (
    0 => 
    array (
      'path' => '/var/www/html/apps',
      'url' => '/apps',
      'writable' => false,
    ),
    1 => 
    array (
      'path' => '/var/www/html/custom_apps',
      'url' => '/custom_apps',
      'writable' => true,
    ),
  ),
  'memcache.distributed' => '\\OC\\Memcache\\Redis',
  'memcache.locking' => '\\OC\\Memcache\\Redis',
  'redis' => 
  array (
    'host' => 'redis',
    'password' => '',
    'port' => 6379,
  ),
  'upgrade.disable-web' => true,
  'instanceid' => 'instanceID',
  'passwordsalt' => 'passwordSalt',
  'secret' => 'secret',
  'trusted_domains' => 
  array (
    0 => 'mydomain.com',
  ),
  'datadirectory' => '/var/www/html/data',
  'dbtype' => 'mysql',
  'version' => '33.0.0.16',
  'overwrite.cli.url' => 'http://mydomain.com',
  'dbname' => 'nextcloud',
  'dbhost' => 'db',
  'dbtableprefix' => 'oc_',
  'mysql.utf8mb4' => true,
  'dbuser' => 'nc-user',
  'dbpassword' => 'db-password',
  'installed' => true,
  'mail_smtppassword' => 'smtppassword',
  'mail_smtpname' => 'nextcloud@mydomain.com',
  'mail_domain' => 'mydomain.com',
  'mail_from_address' => 'nextcloud',
  'mail_smtpmode' => 'smtp',
  'mail_smtpsecure' => 'ssl',
  'mail_smtphost' => 'smtphost',
  'mail_smtpauth' => true,
  'mail_smtpport' => '465',
  'mail_sendmailmode' => 'smtp',
  'mail_smtpstreamoptions' => 
  array (
    'ssl' => 
    array (
      'allow_self_signed' => false,
      'verify_peer' => true,
      'verify_peer_name' => true,
    ),
  ),
  'defaultapp' => '',
  'default_phone_region' => 'FR',
  'skeletondirectory' => '',
  'maintenance_window_start' => 0,
  'maintenance' => true,
  'trusted_proxies' => 
  array (
    0 => '127.0.0.1',
  ),
  'overwritehost' => 'mydomain.com',
  'overwriteprotocol' => 'https',
  'twofactor_enforced' => 'true',
  'twofactor_enforced_groups' => 
  array (
    0 => 'admin',
  ),
  'twofactor_enforced_excluded_groups' => 
  array (
    0 => 'G1',
    1 => 'G2',
    2 => 'G3',
    3 => 'G4',
    4 => 'G5',
    5 => 'G6',
    6 => 'G7',
  ),
  'data-fingerprint' => 'b76cc283998c7bdb4438990ce1d1e0ed',
  'app_install_overwrite' => 
  array (
  ),
);

Apps

The output of occ app:list (if possible).

Nextcloud or one of the apps require upgrade - only a limited number of commands are available
You may use your browser or the occ upgrade command to do the upgrade
Enabled:
  - activity: 6.0.0-dev.0
  - admin_audit: 1.23.0
  - app_api: 33.0.0
  - bruteforcesettings: 6.0.0-dev.0
  - calendar: 6.5.4
  - circles: 33.0.0
  - cloud_federation_api: 1.17.0
  - contactsinteraction: 1.14.1
  - dashboard: 7.13.0
  - dav: 1.36.0
  - federatedfilesharing: 1.23.0
  - federation: 1.23.0
  - files: 2.5.0
  - files_antivirus: 6.3.0
  - files_downloadlimit: 5.1.0-dev.0
  - files_pdfviewer: 6.0.0-dev.0
  - files_reminders: 1.6.0
  - files_sharing: 1.25.2
  - files_trashbin: 1.23.0
  - files_versions: 1.26.0
  - forms: 5.3.2
  - groupfolders: 21.0.9
  - intravox: 2.2.0
  - lookup_server_connector: 1.21.0
  - metavox: 2.2.0
  - notifications: 6.0.0
  - notify_push: 1.3.3
  - oauth2: 1.21.0
  - onlyoffice: 10.1.2
  - password_policy: 5.0.0-dev.0
  - polls: 9.1.4
  - privacy: 5.0.0-dev.0
  - profile: 1.2.0
  - provisioning_api: 1.23.0
  - quota_warning: 1.24.0
  - recommendations: 6.0.0-dev.0
  - related_resources: 4.0.0-dev.0
  - serverinfo: 5.0.0-dev.0
  - settings: 1.16.0
  - sharebymail: 1.23.0
  - spreed: 23.0.7
  - support: 5.0.0
  - survey_client: 5.0.0-dev.0
  - text: 7.0.0-dev.3
  - theming: 2.8.0
  - twofactor_backupcodes: 1.22.0
  - twofactor_totp: 15.0.0-dev.0
  - updatenotification: 1.23.0
  - user_status: 1.13.0
  - viewer: 6.0.0-dev.0
  - webhook_listeners: 1.5.0
  - workflowengine: 2.15.0
Disabled:
  - comments: 1.23.0 (installed 1.23.0)
  - contacts: 8.7.2 (installed 8.7.2)
  - encryption: 2.21.0
  - files_external: 1.25.1
  - firstrunwizard: 6.0.0-dev.0 (installed 6.0.0-dev.0)
  - logreader: 6.0.0 (installed 6.0.0)
  - mail: 5.10.5 (installed 5.10.5)
  - nextcloud_announcements: 5.0.0 (installed 5.0.0)
  - notes: 6.0.1 (installed 6.0.1)
  - photos: 6.0.0-dev.0 (installed 6.0.0-dev.0)
  - richdocuments: 10.2.0 (installed 10.2.0)
  - richdocumentscode: 26.4.104 (installed 26.4.104)
  - suspicious_login: 11.0.0-dev.0
  - systemtags: 1.23.0 (installed 1.23.0)
  - twofactor_nextcloud_notification: 7.0.0
  - user_ldap: 1.24.0
  - weather_status: 1.13.0 (installed 1.13.0)

Tips for increasing the likelihood of a response

  • Use the preformatted text formatting option in the editor for all log entries and configuration output.
  • If screenshots are useful, feel free to include them.
    • If possible, also include key error output in text form so it can be searched for.
  • Try to edit log output only minimally (if at all) so that it can be ran through analyzers / formatters by those trying to help you.
2

try sudo docker exec --user www-data YOUR_CONTAINER_NAME php occ upgrade
maybe you have to try php8.4 instead of only php

3

Thanks the quick answer! I’m currently running v33 and the latest version is v35. Can occ upgrade possibly break the whole thing?

4

As long as you haven’t downloaded a new server version, this command only updates apps and adds missing database indexes.

5

Check your Nextcloud log before simply turning off maintenance. This occurred for a reason. (You’ll need to provide more details, such as which app you were attempting to update to get any specific guidance from us here on the forum).

See Admin Manual for specifics on app management, etc.

The Updater is for the Nextcloud Server instance itself, not for individual apps. Also note the Updater isn’t applicable to you since you’re using the community Docker image: GitHub - nextcloud/docker: A community maintained docker micro-image for deploying Nextcloud on container platforms · GitHub

Were you perhaps looking for the app updater? See the Admin Manual chapter on app management as well as the command reference for the occ app:* command set.

6

Seems the command “upgrade” did the trick! Thanks to all!

7

occ upgrade is not the right method to upgrade a Docker installation!

please review Docker upgrade procedure

8

never wrote, that this command is for upgrading a docker installation! You have to read first and then comment :wink:
the topic creator wanted to update a plugin, but was stuck in maintenance mode after that. my posted command completes an app or plugin update as you can see in the admin manuals

… you can safely execute occ upgrade manually or simply visit the URL of your instance to complete the database migrations and app upgrade phase.

9

Sorry, but the occ upgrade command is intended to complete the update after you’ve run either the command-line updater (updater.phar) or Nextcloud’s web-based updater to update Nextcloud to a new version. It’s not meant for regular updates of plugins or apps.

For the latter, you would use occ app:update <appname> or occ app:update --all to update all apps. The “app upgrade phase” in your quote refers to app updates that are carried out as part of a Nextcloud version update, not to regular app updates within the same Nextcloud version.

Also, you usually only need to run the occ upgrade command manually if you selected “No” when updater.phar asked whether you wanted to run it, or if you didn’t click the corresponding button in the Web Updater and/or it failed to run for some reason.

If you had quoted the entire paragraph from the documentation, it actually says that there, too: :wink:

If you accidentally say no when the command-line mode of the updater asks if you’d like to run occ upgrade, you can safely execute occ upgrade manually or simply visit the URL of your instance to complete the database migrations and app upgrade phase.

10

Thanks for the additional information!

To add some context, I tried initially to run the command line updater, but couldn’t find any update/updater.phar file: how can I add this function to the existing instance?

Thanks for any help!

11

I don’t use a Docker installation myself. But as @wwe already mentioned, Nextcloud updates with Docker don’t work through the built-in updater. Updating the Nextcloud container is done by pulling the new image, throwing away the old container, and starting a new one. So from my point of view, it makes sense that the updater isn’t exposed there. See also here: GitHub - nextcloud/docker: A community maintained docker micro-image for deploying Nextcloud on container platforms · GitHub

But yeah, unfortunately I can’t really help if there are problems after an update, since, as I said, I don’t use the Docker images myself.

12

Thanks a lot, this is probably the good reason for the lack of updater.phar…

Thanks to all!