diff --git a/docs/troubleshooting.md b/docs/troubleshooting.md index 63e37a10f..baf91a27c 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.