From cc971a4569513f71dbc699f8df92ed30d4919e41 Mon Sep 17 00:00:00 2001
From: shamoon <4887959+shamoon@users.noreply.github.com>
Date: Sun, 5 Feb 2023 06:29:06 -0800
Subject: [PATCH] Note possible `utf8mb3` requirement

---
 docs/advanced_usage.md | 6 ++++++
 docs/setup.md          | 6 ++++++
 2 files changed, 12 insertions(+)

diff --git a/docs/advanced_usage.md b/docs/advanced_usage.md
index 9a1abcfff..61e7eee20 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 391ef7850..7eaaf69f7 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: