Updater broken "Excluding subpaths is not supported yet"

The Basics

  • Nextcloud Server version (e.g., 29.x.x):
    • 35.0.2
  • Operating system and version (e.g., Ubuntu 24.04):
    • Debian GNU/Linux 12
  • Web server and version (e.g, Apache 2.4.25):
    • nginx/1.22.1
  • Reverse proxy and version _(e.g. nginx 1.27.2)
    • nginx/1.22.1
  • PHP version (e.g, 8.3):
    • PHP 8.3.36
  • Is this the first time you’ve seen this error? (Yes / No):
    • yes
  • When did this problem seem to first start?
    • a couple of versions ago
  • Installation method (e.g. AlO, NCP, Bare Metal/Archive, etc.)
    • bare metal
  • Are you using CloudfIare, mod_security, or similar? (Yes / No)
    • no

Summary of the issue you are facing:

When running the updater from cli - at the step “deleting files” I get the error:

Excluding subpaths is not supported yet

[✘] Delete old files failed
Excluding subpaths is not supported yet

Update failed. To resume or retry just execute the updater again.

Steps to replicate it:

  1. sudo -u www-data php /var/www/nextcloud/updater/updater.phar

  2. at the “Delete old files” updater stops with error

this is the only instance of NC I host that has this issue… And I can’t figure out why…

looking at the updater php code I wonder what exactly is in “excludedpaths”

is there a way to run the updater.phar without the phar and change the code so the content of the excludedPaths is printed? so I can see why or what element there contains a / so maybe I can find the culprit file? folder?

I then always to a manual update by moving the original nextcloud folder and unzipping the new version manually… but it also does not fix the problem at the next update.

Log entries

2026-10-22T21:48:52+0000 bSNUs5quLE [info] will try to download archive from: https://github.com/nextcloud-releases/server/releases/download/v35.0.2/nextcloud-35.0.2.zip, https://download.nextcloud.com/server/releases/nextcloud-35.0.2.zip
2026-10-22T21:48:52+0000 bSNUs5quLE [info] storage location already exists
2026-10-22T21:48:52+0000 bSNUs5quLE [info] extracted Archive location exists
2026-10-22T21:48:58+0000 bSNUs5quLE [info] download progress: 2% (5.23MiB of 282.22MiB)
2026-10-22T21:48:58+0000 bSNUs5quLE [info] download progress: 4% (9.91MiB of 282.22MiB)
2026-10-22T21:48:58+0000 bSNUs5quLE [info] download progress: 6% (16.33MiB of 282.22MiB)
2026-10-22T21:49:00+0000 bSNUs5quLE [info] download progress: 8% (21.25MiB of 282.22MiB)
2026-10-22T21:49:02+0000 bSNUs5quLE [info] download progress: 10% (27.54MiB of 282.22MiB)
2026-10-22T21:49:03+0000 bSNUs5quLE [info] download progress: 20% (55.86MiB of 282.22MiB)
2026-10-22T21:49:03+0000 bSNUs5quLE [info] download progress: 30% (83.33MiB of 282.22MiB)
2026-10-22T21:49:03+0000 bSNUs5quLE [info] download progress: 40% (112.43MiB of 282.22MiB)
2026-10-22T21:49:04+0000 bSNUs5quLE [info] download progress: 50% (140MiB of 282.22MiB)
2026-10-22T21:49:04+0000 bSNUs5quLE [info] download progress: 60% (168.48MiB of 282.22MiB)
2026-10-22T21:49:05+0000 bSNUs5quLE [info] download progress: 70% (197.34MiB of 282.22MiB)
2026-10-22T21:49:05+0000 bSNUs5quLE [info] download progress: 80% (224.66MiB of 282.22MiB)
2026-10-22T21:49:05+0000 bSNUs5quLE [info] download progress: 90% (253.66MiB of 282.22MiB)
2026-10-22T21:49:06+0000 bSNUs5quLE [info] download progress: 100% (281.26MiB of 282.22MiB)
2026-10-22T21:49:06+0000 bSNUs5quLE [info] download stats: size=282.22MiB bytes; total_time=7.93 secs; avg speed=35.6MiB/sec
2026-10-22T21:49:06+0000 bSNUs5quLE [info] end of downloadUpdate()
2026-10-22T21:49:06+0000 bSNUs5quLE [info] endStep("4")
2026-10-22T21:49:06+0000 bSNUs5quLE [info] executeStep request for step "5"
2026-10-22T21:49:06+0000 bSNUs5quLE [info] startStep("5")
2026-10-22T21:49:07+0000 bSNUs5quLE [info] verifyIntegrity()
2026-10-22T21:49:07+0000 bSNUs5quLE [info] getUpdateServerResponse()
2026-10-22T21:49:07+0000 bSNUs5quLE [info] updaterServer: https://updates.nextcloud.com/updater_server/
2026-10-22T21:49:07+0000 bSNUs5quLE [info] releaseChannel: stable
2026-10-22T21:49:07+0000 bSNUs5quLE [info] internal version: 34.0.5.1
2026-10-22T21:49:07+0000 bSNUs5quLE [info] updateURL: https://updates.nextcloud.com/updater_server/?version=34x0x5x1xxxstablexx2026-10-15T08%3A24%3A38%2B00%3A00+77e3cab12d2215bf94d6de67f23b98ed7bad236ex8x3x36
2026-10-22T21:49:07+0000 bSNUs5quLE [info] getUpdateServerResponse response: Array
(
    [version] => 35.0.2.2
    [versionstring] => Nextcloud 35.0.2
    [url] => https://download.nextcloud.com/server/releases/nextcloud-35.0.2.zip
    [downloads] => SimpleXMLElement Object
        (
            [bz2] => Array
                (
                    [0] => https://github.com/nextcloud-releases/server/releases/download/v35.0.2/nextcloud-35.0.2.tar.bz2
                    [1] => https://download.nextcloud.com/server/releases/nextcloud-35.0.2.tar.bz2
                )

            [zip] => Array
                (
                    [0] => https://github.com/nextcloud-releases/server/releases/download/v35.0.2/nextcloud-35.0.2.zip
                    [1] => https://download.nextcloud.com/server/releases/nextcloud-35.0.2.zip
                )

        )

    [web] => https://docs.nextcloud.com/server/35/admin_manual/maintenance/upgrade.html
    [changes] => https://updates.nextcloud.com/changelog_server/?version=35.0.2
    [autoupdater] => 1
    [eol] => 0
    [eolDate] => SimpleXMLElement Object
        (
        )

    [signature] => qxz/s0Plz6RgzQhdXcGlSE4GGvMM8nwIIbwdmSY0SU44OZ5mC6Ze8ER70i2TvZZ2
KcT9j/bUK978HQPqMIMpqTaQ+WGSJg/TBqq8jZ+j0uRXuZSTjvK0fT/thvihA2M/
ld2WxQicywT4nq2Ngniv0o65BHOyctfwusG/3vta1hMeQCATgnteF8ah49twJFCl
k9CKr9syLv4082nF3Y0SjYew7niHqoILpJhB2LIN3kFrhHQ/CoG9/7nI4YoYVr+9
2R66xNK0CJHjEsj6V32ZghJgbzkWKbEugB2SyxKlaOtnXNYPJxNvnZ0EcM5pXwnW
u2GAP6gaHBhFFjM2AeBopA==
)

2026-10-22T21:49:07+0000 bSNUs5quLE [info] storage location: /oc_data/owncloud/data//updater-oc90bef3ea20/downloads/
2026-10-22T21:49:08+0000 bSNUs5quLE [info] end of verifyIntegrity()
2026-10-22T21:49:08+0000 bSNUs5quLE [info] endStep("5")
2026-10-22T21:49:09+0000 bSNUs5quLE [info] executeStep request for step "6"
2026-10-22T21:49:09+0000 bSNUs5quLE [info] startStep("6")
2026-10-22T21:49:09+0000 bSNUs5quLE [info] extractDownload()
2026-10-22T21:49:09+0000 bSNUs5quLE [info] storage location: /oc_data/owncloud/data//updater-oc90bef3ea20/downloads/
2026-10-22T21:49:09+0000 bSNUs5quLE [info] Libzip version detected: 1.7.3
2026-10-22T21:49:21+0000 bSNUs5quLE [info] end of extractDownload()
2026-10-22T21:49:21+0000 bSNUs5quLE [info] endStep("6")
2026-10-22T21:49:21+0000 bSNUs5quLE [info] executeStep request for step "7"
2026-10-22T21:49:21+0000 bSNUs5quLE [info] startStep("7")
2026-10-22T21:49:21+0000 bSNUs5quLE [info] setMaintenanceMode("true")
2026-10-22T21:49:21+0000 bSNUs5quLE [info] configFileName /var/www/nextcloud/config/config.php
2026-10-22T21:49:21+0000 bSNUs5quLE [info] end of setMaintenanceMode()
2026-10-22T21:49:21+0000 bSNUs5quLE [info] endStep("7")
2026-10-22T21:49:21+0000 bSNUs5quLE [info] executeStep request for step "8"
2026-10-22T21:49:21+0000 bSNUs5quLE [info] startStep("8")
2026-10-22T21:49:21+0000 bSNUs5quLE [info] replaceEntryPoints()
2026-10-22T21:49:21+0000 bSNUs5quLE [info] replace index.php
2026-10-22T21:49:21+0000 bSNUs5quLE [info] replace status.php
2026-10-22T21:49:21+0000 bSNUs5quLE [info] replace remote.php
2026-10-22T21:49:21+0000 bSNUs5quLE [info] replace public.php
2026-10-22T21:49:21+0000 bSNUs5quLE [info] replace ocs/v1.php
2026-10-22T21:49:21+0000 bSNUs5quLE [info] replace ocs/v2.php
2026-10-22T21:49:21+0000 bSNUs5quLE [info] end of replaceEntryPoints()
2026-10-22T21:49:21+0000 bSNUs5quLE [info] endStep("8")
2026-10-22T21:49:21+0000 bSNUs5quLE [info] executeStep request for step "9"
2026-10-22T21:49:21+0000 bSNUs5quLE [info] startStep("9")
2026-10-22T21:49:21+0000 bSNUs5quLE [info] deleteOldFiles()
2026-10-22T21:49:24+0000 bSNUs5quLE [info] config sample exists
2026-10-22T21:49:24+0000 bSNUs5quLE [info] themes README exists
2026-10-22T21:49:24+0000 bSNUs5quLE [error] executeStep request failed with other exception
2026-10-22T21:49:24+0000 bSNUs5quLE [error] Exception: Exception
Message: Excluding subpaths is not supported yet
Code:0
Trace:
#0 phar:///var/www/nextcloud/updater/updater.phar/lib/Updater.php(1138): NC\Updater\Updater->getRecursiveDirectoryIterator()
#1 phar:///var/www/nextcloud/updater/updater.phar/lib/UpdateCommand.php(481): NC\Updater\Updater->deleteOldFiles()
#2 phar:///var/www/nextcloud/updater/updater.phar/lib/UpdateCommand.php(267): NC\Updater\UpdateCommand->executeStep()
#3 phar:///var/www/nextcloud/updater/updater.phar/vendor/symfony/console/Command/Command.php(326): NC\Updater\UpdateCommand->execute()
#4 phar:///var/www/nextcloud/updater/updater.phar/vendor/symfony/console/Application.php(1070): Symfony\Component\Console\Command\Command->run()
#5 phar:///var/www/nextcloud/updater/updater.phar/vendor/symfony/console/Application.php(324): Symfony\Component\Console\Application->doRunCommand()
#6 phar:///var/www/nextcloud/updater/updater.phar/vendor/symfony/console/Application.php(175): Symfony\Component\Console\Application->doRun()
#7 phar:///var/www/nextcloud/updater/updater.phar/updater.php(17): Symfony\Component\Console\Application->run()
#8 /var/www/nextcloud/updater/updater.phar(15): require('...')
#9 {main}
File:phar:///var/www/nextcloud/updater/updater.phar/lib/Updater.php
Line:348

2026-10-22T21:49:24+0000 bSNUs5quLE [info] rollbackChanges("9")
2026-10-22T21:49:24+0000 bSNUs5quLE [info] unlink .step
2026-10-22T21:49:24+0000 bSNUs5quLE [info] rollbackChanges - step >= 7
2026-10-22T21:49:24+0000 bSNUs5quLE [info] end of  rollbackChanges()

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!):

{
    "system": {
        "instanceid": "***REMOVED SENSITIVE VALUE***",
        "serverid": "42",
        "passwordsalt": "***REMOVED SENSITIVE VALUE***",
        "datadirectory": "***REMOVED SENSITIVE VALUE***",
        "dbtype": "mysql",
        "version": "35.0.2.2",
        "dbname": "***REMOVED SENSITIVE VALUE***",
        "dbhost": "***REMOVED SENSITIVE VALUE***",
        "dbtableprefix": "oc_",
        "dbuser": "***REMOVED SENSITIVE VALUE***",
        "dbpassword": "***REMOVED SENSITIVE VALUE***",
        "installed": true,
        "forcessl": true,
        "knowledgebaseenabled": true,
        "versions_retention_obligation": "10, 30",
        "check_for_working_wellknown_setup": true,
        "check_for_working_htaccess": true,
        "config_is_read_only": false,
        "default_language": "de",
        "ldapIgnoreNamingRules": false,
        "loglevel": 2,
        "logfile": "\/oc_data\/owncloud\/data\/owncloud.log",
        "logtimezone": "Europe\/Vienna",
        "log_authfailip": true,
        "theme": "",
        "memcache.local": "\\OC\\Memcache\\APCu",
        "memcache.distributed": "\\OC\\Memcache\\Redis",
        "filelocking.enabled": true,
        "memcache.locking": "\\OC\\Memcache\\Redis",
        "redis": {
            "host": "***REMOVED SENSITIVE VALUE***",
            "port": 6379,
            "timeout": 0,
            "dbindex": 0,
            "password": "***REMOVED SENSITIVE VALUE***"
        },
        "default_phone_region": "AT",
        "minimum.supported.desktop.version": "1.7.0",
        "session_lifetime": 3600,
        "logdateformat": "H:i:s Y-m-d",
        "log_rotate_size": 2097152,
        "cron_log": true,
        "trashbin_retention_obligation": "auto, 365",
        "overwritewebroot": "",
        "enable_previews": "true",
        "enabledPreviewProviders": [
            "OC\\Preview\\PNG",
            "OC\\Preview\\JPEG",
            "OC\\Preview\\GIF",
            "OC\\Preview\\BMP",
            "OC\\Preview\\XBitmap",
            "OC\\Preview\\MP3",
            "OC\\Preview\\TXT",
            "OC\\Preview\\MarkDown",
            "OC\\Preview\\OpenDocument",
            "OC\\Preview\\Krita"
        ],
        "appstore.experimental.enabled": true,
        "defaultapp": "files",
        "enable_avatars": true,
        "allow_user_to_change_display_name": false,
        "remember_login_cookie_lifetime": 3600,
        "session_keepalive": false,
        "skeletondirectory": "",
        "activity_expire_days": 100,
        "preview_libreoffice_path": "\/usr\/bin\/libreoffice",
        "secret": "***REMOVED SENSITIVE VALUE***",
        "forceSSLforSubdomains": true,
        "mail_domain": "***REMOVED SENSITIVE VALUE***",
        "mail_smtpmode": "smtp",
        "mail_from_address": "***REMOVED SENSITIVE VALUE***",
        "updater.release.channel": "stable",
        "appcodechecker": false,
        "ldapProviderFactory": "\\OCA\\User_LDAP\\LDAPProviderFactory",
        "apps_paths": [
            {
                "path": "\/var\/www\/nextcloud\/apps\/",
                "url": "\/apps",
                "writable": true
            }
        ],
        "maintenance": false,
        "mail_smtphost": "***REMOVED SENSITIVE VALUE***",
        "mail_smtpport": "587",
        "mysql.utf8mb4": true,
        "lost_password_link": "disabled",
        "allow_local_remote_servers": true,
        "profile.enabled": false,
        "maintenance_window_start": 1,
        "trusted_proxies": "***REMOVED SENSITIVE VALUE***",
        "forbidden_filename_characters": [
            "<",
            ">",
            ":",
            "\"",
            "|",
            "?",
            "*",
            "\\",
            "\/"
        ],
        "forbidden_filename_extensions": [
            " ",
            ".",
            ".filepart",
            ".part"
        ],
        "forbidden_filename_basenames": [
            "con",
            "prn",
            "aux",
            "nul",
            "com0",
            "com1",
            "com2",
            "com3",
            "com4",
            "com5",
            "com6",
            "com7",
            "com8",
            "com9",
            "com\u00b9",
            "com\u00b2",
            "com\u00b3",
            "lpt0",
            "lpt1",
            "lpt2",
            "lpt3",
            "lpt4",
            "lpt5",
            "lpt6",
            "lpt7",
            "lpt8",
            "lpt9",
            "lpt\u00b9",
            "lpt\u00b2",
            "lpt\u00b3"
        ],
        "mail_smtppassword": "***REMOVED SENSITIVE VALUE***",
        "mail_smtpname": "***REMOVED SENSITIVE VALUE***",
        "mail_smtpauth": true,
        "mail_sendmailmode": "smtp",
        "mail_smtpstreamoptions": {
            "ssl": {
                "allow_self_signed": true,
                "verify_peer": false,
                "verify_peer_name": false
            }
        },
        "app_install_overwrite": []
    }
}

Apps

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

Enabled:
  - activity: 8.0.0
  - admin_audit: 2.0.0
  - appstore: 2.0.0
  - bruteforcesettings: 8.0.0
  - calendar: 6.6.3
  - checksum: 2.1.2
  - circles: 35.0.0
  - cloud_federation_api: 2.0.0
  - comments: 2.0.0
  - dav: 2.0.0
  - deck: 1.19.0
  - federatedfilesharing: 2.0.0
  - files: 3.0.0
  - files_accesscontrol: 6.0.1
  - files_downloadlimit: 5.3.0
  - files_fulltextsearch: 35.0.0
  - files_lock: 35.0.1
  - files_pdfviewer: 8.0.0
  - files_reminders: 2.0.0
  - files_retention: 6.0.0
  - files_sharing: 2.0.0
  - files_trashbin: 2.0.0
  - files_versions: 2.0.0
  - forms: 5.4.0
  - fulltextsearch: 35.0.0
  - fulltextsearch_elasticsearch: 35.0.1
  - groupfolders: 23.0.1
  - impersonate: 6.0.0
  - logreader: 8.0.0
  - lookup_server_connector: 2.0.0
  - nextcloud_announcements: 7.0.0
  - notifications: 8.0.1
  - notify_push: 1.4.2
  - oauth2: 2.0.0
  - office: 1.1.0
  - password_policy: 7.0.0
  - photos: 8.0.0
  - polls: 9.3.0
  - privacy: 7.0.0
  - profile: 2.0.0
  - provisioning_api: 2.0.0
  - recommendations: 8.0.0
  - related_resources: 6.0.0
  - richdocuments: 12.0.1
  - serverinfo: 7.0.0
  - settings: 2.0.0
  - sharebymail: 2.0.0
  - sharing: 1.0.4
  - spreed: 25.0.6
  - support: 7.0.0
  - suspicious_login: 13.0.0
  - text: 9.0.1
  - theming: 3.0.0
  - twofactor_admin: 4.13.0
  - twofactor_backupcodes: 2.0.0
  - twofactor_totp: 17.1.0
  - twofactor_webauthn: 2.7.1
  - updatenotification: 2.0.0
  - user_ldap: 2.0.0
  - viewer: 8.0.0
  - weather_status: 2.0.0
  - webhook_listeners: 2.0.0
  - workflowengine: 3.0.0
Disabled:
  - app_api: 35.0.0 (installed 4.0.0)
  - contactsinteraction: 2.0.0 (installed 1.9.0)
  - dashboard: 8.0.0 (installed 7.0.0)
  - encryption: 3.0.1 (installed 1.3.1)
  - federation: 2.0.0 (installed 1.7.0)
  - files_external: 2.0.0 (installed 1.1.2)
  - firstrunwizard: 8.0.0 (installed 2.18.0)
  - survey_client: 7.0.0 (installed 0.1.5)
  - systemtags: 2.0.0 (installed 1.21.1)
  - twofactor_nextcloud_notification: 9.0.0
  - user_status: 2.0.0 (installed 1.0.1)

Drop the slash at the end - e.g.

       "apps_paths": [
            {
                "path": "\/var\/www\/nextcloud\/apps",

It appears the Updater is less resilient against that than in core itself for this config parameter, which automatically trims it if present:

EDIT: Adding a tracking Issue to align the implementations: Align apps_paths parsing with core - Excluding subpaths is not supported yet · Issue #783 · nextcloud/updater · GitHub

Oh, could it really be that simple? :wink: I removed the slash and will see what will happen with the next update :slight_smile: