Nextcloud Server 32.0.0 → 33.0.0
8 versions, 6 critical-change sections in 1 version, 1 required stop
Required stops
- 32.0.15
Latest 32.x release.
Nextcloud must be upgraded step by step:
- Before you can upgrade to the next major release, you need to upgrade to the latest point release of your current major version.
- Then run the upgrade again to upgrade to the next major release’s latest point release.
- You cannot skip major releases. Please re-run the upgrade until you have reached the highest available (or applicable) release.
- Example: 18.0.5 -> 18.0.11 -> 19.0.5 -> 20.0.2
Wait for background migrations to finish after major upgrades. After upgrading to a new major version, some migrations are scheduled to run as a background job. If you plan to upgrade directly to another major version (e.g. 24 -> 25 -> 26) you need to make sure these migrations were executed before starting the next upgrade. To do so you should run the
cron.phpfile 2-3 times, for example:$ sudo -E -u www-data php -f /var/www/nextcloud/cron.phpSource: https://docs.nextcloud.com/server/latest/admin_manual/maintenance/upgrade.html (checked 2026-09-26)
Version by version, oldest first
32.0.1 – 32.0.6: no action items (6 versions)
32.0.7 – 32.0.14: released after 33.0.0; not on this route
32.0.15 2026-09-10
Required stop
33.0.0 2026-02-18
Quoted from docs.nextcloud.com/server/latest/admin_manual/release_notes/upgrade_to_33.html
Critical change
System requirements
- PHP 8.5 is now supported.
- PHP 8.2 is now deprecated but still supported.
- PHP 8.1 is no longer supported.
- Oracle 11g is no longer supported.
- PostgreSQL 13 is no longer supported.
If you configured restrictions on which domains can be contacted on the internet, you need to add connectivity.nextcloud.com to the allowlist, as it’s now used by default to test internet connectivity instead of www.nextcloud.com. You can also configure any other URL to use in the configuration instead. See Connections to remote servers.
Critical change
Previews
The preview provider for MP3 files, which reads cover images embedded in the files, is disabled by default for performance and stability reasons. See Previews configuration for details on how to enable or disable the preview provider.
Critical change
Snowflake IDs
This version of Nextcloud ships with Snowflake IDs. Those IDs include the creation time of object, a sequence ID and a server ID. The server ID should now be configured in your config.php file or using environment variables. See Configuration Parameters for more information.
Critical change
OpenMetrics endpoint
Nextcloud 33 introduces a /metrics endpoint that can be integrated into every OpenMetrics (Prometheus) system. For security, it only answers on localhost by default.
See Monitoring for more information about it.
Critical change
Default user agent for outgoing requests changed
Starting with this release, the default user agent for requests done by the instance was changed from Nextcloud Server Crawler to Nextcloud-Server-Crawler/X.Y.Z, where X.Y.Z is the current server version.
Critical change
TaskProcessing worker command
Previously we instructed admins to run occ background-job:worker <JobClass> to speed up AI task processing. This recommendation has changed to running occ taskprocessing:worker, which handles parallel execution better. Make sure to update your setup.
See Overview for more information about this.
Release notes from github.com/nextcloud/server/releases, and Upgrade to Nextcloud 33, checked 17 hours ago. Only text the vendor marks as breaking, or puts in a warning/caution/important note, is shown; read the full notes for anything else. Nextcloud's GitHub release notes are lists of merged pull requests and mark nothing as breaking. What is quoted instead is the admin manual's “Critical changes” page for each major version (Upgrade to Nextcloud 26, 27, 28, 30, 31, 32, 33 and 35; there is none for 29 or 34), one item per section, labelled “Critical change”, on the x.0.0 release. The manual has no such pages before 26. Versions are covered from 23.0.0; GitHub has no complete release list before that. Required stops are the latest point release of each major version on the way, per the manual's upgrade page.