Merge pull request #13091 from nextcloud/backport/13086/stable31

[stable31] explain v31 db row format warning
This commit is contained in:
Ferdinand Thiessen
2025-04-29 09:52:57 +02:00
committed by GitHub

View File

@@ -8,6 +8,16 @@ System requirements
* PHP 8.1 is now deprecated but still supported.
* PHP 8.4 is now supported, but 8.3 is recommended.
Database configuration
----------------------
Other row formats than ``DYNAMIC`` for MySQL and MariaDB databases will `issue a warning since Nextcloud 24 <https://github.com/nextcloud/server/issues/34497>`_,
as they often cause performance issues.
With Nextcloud 31 a `more prominent new setup warning <https://github.com/nextcloud/server/pull/48547>`_ for this was added.
To resolve the warning, in most cases running ``occ db:convert-mysql-charset`` will resolve the issue.
If some tables are not covered by the ``occ`` command, issuing the proper ``ALTER TABLE`` DDL commands to change the row format during a maintenance window is needed.
If you're not sure how to do this, you can `find some tips and tricks from the community <https://help.nextcloud.com/t/upgrade-to-nextcloud-hub-10-31-0-0-incorrect-row-format-found-in-your-database/218366/>`_.
PHP configuration
-----------------