From: shamoon <4887959+shamoon@users.noreply.github.com>
Date: Tue, 29 Aug 2023 02:29:36 +0000 (-0700)
Subject: Add Ghostscript error to troubleshooting docs
X-Git-Tag: v1.17.4~3
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=96aa2451bf39c91a5bb2ae89c69a3986878a7d0a;p=thirdparty%2Fpaperless-ngx.git

Add Ghostscript error to troubleshooting docs
---

diff --git a/docs/troubleshooting.md b/docs/troubleshooting.md
index 63e37a10fd..baf91a27c8 100644
--- a/docs/troubleshooting.md
+++ b/docs/troubleshooting.md
@@ -345,3 +345,11 @@ STATEMENT:  INSERT INTO "documents_tag" ("owner_id", "name", "match", "matching_
 
 This can happen during heavy consumption when using polling. Paperless will handle it correctly and the file
 will still be consumed
+
+## Consumption fails with "Ghostscript PDF/A rendering failed"
+
+Newer versions of OCRmyPDF will fail if it encounters errors during processing.
+This is intentional as the output archive file may differ in unexpected or undesired
+ways from the original. As the logs indicate, if you encounter this error you can set
+`PAPERLESS_OCR_USER_ARGS: '{"continue_on_soft_render_error": true}'` to try to 'force'
+processing documents with this issue.