From ffba4875a2a831a5710658c18ebb721509d7da6c Mon Sep 17 00:00:00 2001 From: Ferdinand Thiessen Date: Mon, 22 Jun 2026 10:59:08 +0200 Subject: [PATCH] docs: document removal of MySQL v8.0 and adding v9.7 LTS Signed-off-by: Ferdinand Thiessen --- .../installation/system_requirements.rst | 2 +- admin_manual/release_notes/upgrade_to_35.rst | 11 ++++++++++ .../release_notes/deprecations.rst | 21 +++++++++++++++---- 3 files changed, 29 insertions(+), 5 deletions(-) diff --git a/admin_manual/installation/system_requirements.rst b/admin_manual/installation/system_requirements.rst index 2861e2f330d..4b8e3de355a 100644 --- a/admin_manual/installation/system_requirements.rst +++ b/admin_manual/installation/system_requirements.rst @@ -25,7 +25,7 @@ For best performance, stability and functionality we have documented some recomm | | - CentOS Stream | | | - Alpine Linux | +------------------+-----------------------------------------------------------------------+ -| Database | - MySQL 8.0 / 8.4 | +| Database | - MySQL 8.4 / 9.7 | | | - MariaDB 10.6 / 10.11 / 11.4 / **11.8** (recommended) | | | - Oracle Database 19c, 21c, 23ai | | | (*only as part of an enterprise subscription*) | diff --git a/admin_manual/release_notes/upgrade_to_35.rst b/admin_manual/release_notes/upgrade_to_35.rst index 09ad6c3d083..ff3aed6b944 100644 --- a/admin_manual/release_notes/upgrade_to_35.rst +++ b/admin_manual/release_notes/upgrade_to_35.rst @@ -11,3 +11,14 @@ System requirements - The minimum supported version of *SUSE Linux Enterprise Server 15* has been bumped to SP7. - The minimum supported version of *Debian Linux* has been bumped to *13 (Trixie)*. - The minimum supported version of *Ubuntu Linux* has been bumped to *24.04*. + +- The list of officially supported databases has been updated: + + - MySQL 8.0 is out of support and thus Nextcloud dropped support for it. + The minimum supported version of MySQL is now 8.4 LTS. + - MySQL 9.7 is released as a new LTS version and is now supported by Nextcloud. + + .. note:: MySQL 9+ dropped support for MD5, some parts of the Nextcloud ecosystem might stilly rely on it. + You need to make sure that after upgrading to MySQL 9+ you load the MySQL component for MD5 support, to do so run this on your MySQL 9+ server: + + ``INSTALL COMPONENT 'file://component_classic_hashing';`` diff --git a/developer_manual/release_notes/deprecations.rst b/developer_manual/release_notes/deprecations.rst index 72fdc4dfea9..c85269eae75 100644 --- a/developer_manual/release_notes/deprecations.rst +++ b/developer_manual/release_notes/deprecations.rst @@ -16,12 +16,25 @@ New deprecations .. Add one section for each group of deprecations (e.g. group files api changes, authentication changes). Also deprecate the feature at their dedicated documentation page. - After branch-off the contents below will be cleared. + After branch-off the contents below will be cleared and moved to the "Older deprecations" section. -.. todo:: This page needs a section for every new deprecation. +.. .. todo:: This page needs a section for every new deprecation. -- ``\OCP\Broadcast\Events\\IBroadcastEvent`` is now deprecated as it is unused. -- ``\OCP\TaskProcessing\ISynchronousWatermarkingProvider`` is now deprecated. ``\OCP\TaskProcessing\ISynchronousOptionsAwareProvider`` should now be used. +Database +^^^^^^^^ + +- ``\OCP\DB\QueryBuilder\IFunctionBuilder::md5`` is now deprecated. + MD5 is not considered secure anymore, thus most databases have or will drop support for this SQL function. + +Events +^^^^^^ + +- ``\OCP\Broadcast\Events\IBroadcastEvent`` is now deprecated as it is unused. + +Task processing +^^^^^^^^^^^^^^^ + +- ``\OCP\TaskProcessing\ISynchronousWatermarkingProvider`` is now deprecated, instead use ``\OCP\TaskProcessing\ISynchronousOptionsAwareProvider`` now. Older deprecations ------------------