mirror of
https://github.com/nextcloud/documentation.git
synced 2025-08-16 16:07:43 +00:00
495247ae4a
Use `sudo -E -u www-data php occ` everywhere. Motivation: this should work on more appliances like also inside docker containers. Signed-off-by: Simon L. <szaimen@e.mail.de>
75 lines
2.6 KiB
ReStructuredText
75 lines
2.6 KiB
ReStructuredText
=============================
|
|
Enabling MySQL 4-byte support
|
|
=============================
|
|
|
|
.. note::
|
|
|
|
Be sure to backup your database before performing this database upgrade.
|
|
|
|
In order to use Emojis (textbased smilies) on your Nextcloud server with a MySQL database, the
|
|
installation needs to be tweaked a bit.
|
|
|
|
.. warning::
|
|
|
|
This manual only covers MySQL 8 or newer and MariaDB 10.2 or newer.
|
|
If you use MariaDB 10.2, please check
|
|
`this older version <https://docs.nextcloud.com/server/20/admin_manual/configuration_database/mysql_4byte_support.html#mariadb-10-2-or-earlier>`_
|
|
of the documentation. If you use an older version of MySQL or MariaDB, please note that they are no longer supported
|
|
by the current Nextcloud version.
|
|
|
|
1. Make sure the following InnoDB settings are set on your MySQL server::
|
|
|
|
[mysqld]
|
|
innodb_file_per_table=1
|
|
|
|
2. Restart the MySQL server in case you changed the configuration in step 1.
|
|
|
|
You can then verify that the change worked:
|
|
|
|
.. code-block:: sql
|
|
|
|
SHOW VARIABLES LIKE 'innodb_file_per_table';
|
|
|
|
The result should look like this::
|
|
|
|
mysql> SHOW VARIABLES LIKE 'innodb_file_per_table';
|
|
+-----------------------+-------+
|
|
| Variable_name | Value |
|
|
+-----------------------+-------+
|
|
| innodb_file_per_table | ON |
|
|
+-----------------------+-------+
|
|
1 row in set (0.00 sec)
|
|
|
|
3. Open a shell, change dir (adjust ``/var/www/nextcloud`` to your nextcloud location if needed), and put your nextcloud instance in maintenance mode, if it isn't already::
|
|
|
|
$ cd /var/www/nextcloud
|
|
$ sudo -E -u www-data php occ maintenance:mode --on
|
|
|
|
4. Change your databases character set and collation:
|
|
|
|
.. code-block:: sql
|
|
|
|
ALTER DATABASE nextcloud CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
|
|
|
|
5. Set the ``mysql.utf8mb4`` config to true in your config.php::
|
|
|
|
$ sudo -E -u www-data php occ config:system:set mysql.utf8mb4 --type boolean --value="true"
|
|
|
|
6. Convert all existing tables to the new collation by running the repair step::
|
|
|
|
$ sudo -E -u www-data php occ maintenance:repair
|
|
|
|
.. note::
|
|
|
|
This will also change the `ROW_FORMAT` to `DYNAMIC` for your tables.
|
|
|
|
7. Disable maintenance mode::
|
|
|
|
$ sudo -E -u www-data php occ maintenance:mode --off
|
|
|
|
Now you should be able to use Emojis in your file names, calendar events, comments and many more.
|
|
|
|
.. note::
|
|
|
|
Also make sure your backup strategy still work. If you use ``mysqldump`` make sure to add the ``--default-character-set=utf8mb4`` option. Otherwise your backups are broken and restoring them will result in ``?`` instead of the emojis, making files inaccessible.
|