From: shamoon <4887959+shamoon@users.noreply.github.com>
Date: Sun, 5 Feb 2023 14:29:06 +0000 (-0800)
Subject: Note possible `utf8mb3` requirement
X-Git-Tag: v1.13.0~2^2~1
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=cc971a4569513f71dbc699f8df92ed30d4919e41;p=thirdparty%2Fpaperless-ngx.git

Note possible `utf8mb3` requirement
---

diff --git a/docs/advanced_usage.md b/docs/advanced_usage.md
index 9a1abcfffd..61e7eee201 100644
--- 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 391ef78500..7eaaf69f73 100644
--- 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: