Troubleshooting category
Document Workflow
Paperless-ngx import, OCR, and search checks for one sample document. Start with the guide below, then use the service page if the symptom needs a remote session.
Paperless-ngx Docker Volume Permission Denied: Fix Upload and Import Access
Fix Paperless-ngx Docker volume permission errors when the container cannot read the import volume or write the document store. Step-by-step checks and verification.
Paperless-ngx File Path Not Found: Fix the Watched Import Folder
Troubleshoot Paperless-ngx when files in the watched import folder are ignored. Check Docker volume paths, permissions, and the consume directory to restore automatic imports.
Paperless-ngx PDF Not Indexed: Diagnose an Empty OCR Text Layer
Troubleshoot a Paperless-ngx PDF that imports but has an empty text layer. Check OCR language, image quality, and Docker volume permissions, then verify search and recover safely.
Paperless-ngx Consumer Service Restart: When a File Stays in the Consume Queue
A file remains in the consume queue and never becomes searchable in Docker. Learn how to diagnose and use a paperless ngx consumer service restart to clear the stuck queue.
Paperless-ngx Upload Permission Denied: Fix Container Read and Write Access
Fix Paperless-ngx upload permission denied errors in Docker by checking UID/GID ownership, volume mounts, and write access to the document store, then verify with a test file.
Paperless-ngx Docker Consume Queue Stuck: Diagnose the Watched Volume Before It Clears
A file remains in the Paperless-ngx consume queue and never becomes searchable. Diagnose the Docker watched volume, permissions, and consumer logs to restore processing.
Paperless-ngx OCR Empty Text: When the PDF Imports but the Text Layer Is Blank
Fix Paperless-ngx when a watched PDF imports but OCR leaves an empty text layer. Check OCR language, image resolution, and run a controlled verification test.
Paperless-ngx Duplicate Documents: Why Re-imports Create New Records
Troubleshoot paperless ngx duplicate documents when re-importing the same file into a Docker watched volume. Check checksums, consumer settings, and verify the fix.
Paperless-ngx Email Import Failed: When the Mail Rule Runs but Messages Never Arrive
Troubleshoot Paperless-ngx email import when the mail rule runs but messages or attachments never reach the inbox. Step-by-step checks, verification test, and recovery note.
Paperless-ngx Import Folder Not Detected: Diagnose the Watched Volume
Files in your Docker watched folder are ignored? Follow these checks to confirm the volume mount, permissions, and consumer status, then verify with a test file.
Paperless-ngx OCR Not Working: Why Your PDF Imports With an Empty Text Layer
Troubleshoot Paperless-ngx OCR not working when a PDF imports with an empty text layer. Check Docker OCR language, permissions, and verify with a controlled test.
Paperless-ngx Task Queue Stuck: Clear the Consume Queue Safely
A file sits in the Paperless-ngx consume queue and never becomes searchable. Follow these checks to diagnose a stuck task and recover the document safely.
Paperless-ngx Docker Volume Permission: Fix Denied Upload and Import Access
Troubleshoot Paperless-ngx Docker volume permission errors that block uploads and watched import access. Check UID/GID ownership, verify with a test file, and recover safely.
Paperless-ngx File Path Not Found: Fix the Watched Import Volume
Troubleshoot Paperless-ngx when files in the watched import folder are ignored due to a file path not found error in Docker. Step-by-step checks and verification.
Paperless-ngx PDF Not Indexed: Fix an Empty OCR Text Layer
Troubleshoot Paperless-ngx when a PDF imports but its OCR text layer is empty, so the document is unsearchable. Check OCR language, image quality, and consumer logs.
Paperless-ngx Consumer Service Restart: Clear a Stuck Consume Queue Safely
A file is stuck in the Paperless-ngx consume queue and never becomes searchable. Follow these checks, a controlled restart, and a verification test to restore normal consumption.
Paperless-ngx Document Stuck in Consume: Diagnose the Queue Before It Clears
A file remains in the consume queue and never becomes searchable. Learn how to diagnose a paperless ngx document stuck in consume with Docker volume checks and verification.
Paperless-ngx OCR Produces an Empty Document: Diagnose the Text Layer
Troubleshoot Paperless-ngx when OCR produces an empty document after import from a watched Docker volume, with checks, result interpretation, and a verification test.
Paperless-ngx Upload Permission Denied: Fix Docker Volume Access
Resolve paperless ngx upload permission denied in Docker by checking volume ownership, container user, and write access to the document store.
Paperless-ngx Watch Folder Not Importing: Diagnose the Consume Directory
Files in your Paperless-ngx watched folder are ignored? Diagnose the consume directory mount, permissions, and polling so imports resume.
Paperless-ngx Duplicate Documents on Re-import: Fix the Deduplication Check
Troubleshoot Paperless-ngx duplicate documents when the same file in a watched Docker volume imports twice. Check checksums, consumer logs, and task settings, then verify with a test file.
Paperless-ngx Email Import Failed: Diagnose the Mail Rule and Restore Delivery
Troubleshoot Paperless-ngx email import when the mail rule runs but messages or attachments never reach the inbox. Check IMAP, filters, and container logs.
Paperless-ngx Import Folder Not Detected: Fix the Watched Volume
Files placed in your Docker watched import folder are ignored by Paperless-ngx. Follow these checks to confirm volume mounts, permissions, and consumer status, then verify with a test file.
Paperless-ngx OCR Not Working: Empty Text Layer After Import
Troubleshoot Paperless-ngx OCR not working when PDFs import with an empty or unsearchable text layer from a Docker watched volume. Step-by-step checks and a verification test.
Paperless-ngx Permission Denied on Docker Import Volume: A Step-by-Step Fix
Troubleshoot Paperless-ngx permission denied errors when the Docker container cannot read the import volume or write the document store. Follow these checks to restore access.
Paperless-ngx Import or OCR Fails: Read the Consume Path and Task Log
A single-document path through Paperless-ngx that checks consume visibility, task logs, OCR text, and search.