Note possible `utf8mb3` requirement

diff --git a/docs/advanced_usage.md b/docs/advanced_usage.md
index 9a1abcfffdf908bf1585e32d3111ab5b9c399e9e..61e7eee2014eb1eddb4c0418fc0f5cb3cb398ab2 100644 (file)
--- a/docs/advanced_usage.md
+++ b/docs/advanced_usage.md
@@ -501,3 +501,9 @@ You can also set the default for new tables (this does NOT affect
 existing tables) with:
 
 `ALTER DATABASE <db_name> CHARACTER SET utf8mb4 COLLATE utf8mb4_bin;`
+
+!!! warning
+
+    Using mariadb version 10.4+ is recommended. Using the `utf8mb3` character set on
+    an older system may fix issues that can arise while setting up Paperless-ngx but
+    `utf8mb3` can cause issues with consumption (where `utf8mb4` does not).

diff --git a/docs/setup.md b/docs/setup.md
index 391ef785006258406cbb61f0ecb32e3ff5a52053..7eaaf69f739e5df4deae8c51a12c85133b5f8f41 100644 (file)
--- a/docs/setup.md
+++ b/docs/setup.md
@@ -708,6 +708,12 @@ below use PostgreSQL, but are applicable to MySQL/MariaDB with the
     MySQL also enforces limits on maximum lengths, but does so differently than
     PostgreSQL.  It may not be possible to migrate to MySQL due to this.
 
+!!! warning
+
+    Using mariadb version 10.4+ is recommended. Using the `utf8mb3` character set on
+    an older system may fix issues that can arise while setting up Paperless-ngx but
+    `utf8mb3` can cause issues with consumption (where `utf8mb4` does not).
+
 1.  Stop paperless, if it is running.
 
 2.  Tell paperless to use PostgreSQL: