From 4637e333263a7fd1e10395bb725e838959ff4d64 Mon Sep 17 00:00:00 2001
From: Trenton H <797416+stumpylog@users.noreply.github.com>
Date: Mon, 20 Mar 2023 11:08:06 -0700
Subject: [PATCH] Adds possible scary looking log line that is actually fine to
 troubleshooting

---
 docs/troubleshooting.md | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/docs/troubleshooting.md b/docs/troubleshooting.md
index 1ff020d4f..63e37a10f 100644
--- a/docs/troubleshooting.md
+++ b/docs/troubleshooting.md
@@ -332,3 +332,16 @@ change the port gunicorn listens on.
 
 To fix this, set `PAPERLESS_PORT` again to your desired port, or the
 default of 8000.
+
+## Database Warns about unique constraint "documents_tag_name_uniq
+
+You may see database log lines like:
+
+```
+ERROR:  duplicate key value violates unique constraint "documents_tag_name_uniq"
+DETAIL:  Key (name)=(NameF) already exists.
+STATEMENT:  INSERT INTO "documents_tag" ("owner_id", "name", "match", "matching_algorithm", "is_insensitive", "color", "is_inbox_tag") VALUES (NULL, 'NameF', '', 1, true, '#a6cee3', false) RETURNING "documents_tag"."id"
+```
+
+This can happen during heavy consumption when using polling. Paperless will handle it correctly and the file
+will still be consumed