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
commit e62702e820
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194

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
-----------------