{"id":4988,"date":"2026-01-12T23:30:24","date_gmt":"2026-01-12T22:30:24","guid":{"rendered":"https:\/\/michael-hoepfl.com\/netzwelt\/paperless-ngx-troubleshooting-common-pitfalls-and-quick-checks\/01-2026\/"},"modified":"2026-08-11T14:21:59","modified_gmt":"2026-08-11T12:21:59","slug":"paperless-ngx-troubleshooting-common-pitfalls-and-quick-checks","status":"publish","type":"post","link":"https:\/\/michael-hoepfl.com\/en\/technology\/paperless-ngx-troubleshooting-common-pitfalls-and-quick-checks\/01-2026\/","title":{"rendered":"Paperless-NGX Troubleshooting \u2013 Common Pitfalls and Quick Checks"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">Paperless-ngx is running but not importing documents? OCR returns empty results or the consume folder remains silent? This article brings together the most common practical pitfalls and provides quick checks for systematically narrowing down typical problems in Docker, NAS and NFS setups \u2013 compact, technical and straight to the point.<\/p>\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n<h3 class=\"wp-block-heading has-text-align-center has-medium-font-size\">More Articles About Paperless-ngx<\/h3>\n\n<ul class=\"wp-block-list\">\n<li><a href=\"https:\/\/michael-hoepfl.com\/en\/technology\/what-paperless-ngx-really-delivers-in-everyday-use\/01-2026\/\">What Paperless-NGX Really Delivers in Everyday Use<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/michael-hoepfl.com\/technologie\/paperless-ngx-installieren-voraussetzungen-betriebsmodelle-und-der-weg-zur-lauffaehigen-installation\/01-2026\/\">Installing Paperless-NGX: Requirements, Deployment Models and the Path to a Working Installation<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/michael-hoepfl.com\/technologie\/paperless-ngx-auf-synology-nfs-mounts-saubere-drive-integration-und-ein-stabiles-docker-setup\/01-2026\/\">Paperless-NGX on Synology: NFS Mounts, Clean Drive Integration and a Stable Docker Setup<\/a><\/li>\n<\/ul>\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n<h2 class=\"wp-block-heading\">Paperless Starts, but No Documents Appear in the Inbox<\/h2>\n\n<p class=\"wp-block-paragraph\"><strong>Possible causes:<\/strong><\/p>\n\n<ul class=\"wp-block-list\">\n<li>incorrect or empty consume path<\/li>\n\n\n\n<li>directory not mounted correctly<\/li>\n\n\n\n<li>missing write permissions for the container<\/li>\n<\/ul>\n\n<p class=\"wp-block-paragraph\"><strong>Checks:<\/strong><\/p>\n<pre class=\"wp-block-code\" aria-describedby=\"shcb-language-1\" data-shcb-language-name=\"Bash\" data-shcb-language-slug=\"bash\"><span><code class=\"hljs language-bash shcb-code-table shcb-line-numbers shcb-wrap-lines\"><span class='shcb-loc'><span>docker compose logs paperless | grep -i consume\n<\/span><\/span><span class='shcb-loc'><span>docker <span class=\"hljs-built_in\">exec<\/span> -it paperless ls -l \/usr\/src\/paperless\/consume\n<\/span><\/span><\/code><\/span><small class=\"shcb-language\" id=\"shcb-language-1\"><span class=\"shcb-language__label\">Code language:<\/span> <span class=\"shcb-language__name\">Bash<\/span> <span class=\"shcb-language__paren\">(<\/span><span class=\"shcb-language__slug\">bash<\/span><span class=\"shcb-language__paren\">)<\/span><\/small><\/pre>\n<p class=\"wp-block-paragraph\">\u27a1\ufe0f Is the document really present in the container\u2019s consume directory, rather than only on the host?<\/p>\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n<h2 class=\"wp-block-heading\">Documents Are Imported, but OCR Returns No Text<\/h2>\n\n<p class=\"wp-block-paragraph\"><strong>Possible causes:<\/strong><\/p>\n\n<ul class=\"wp-block-list\">\n<li>OCR languages not configured correctly<\/li>\n\n\n\n<li>unsupported document types<\/li>\n\n\n\n<li>very poor scan quality<\/li>\n<\/ul>\n\n<p class=\"wp-block-paragraph\"><strong>Checks:<\/strong><\/p>\n\n<ul class=\"wp-block-list\">\n<li>Check the OCR language:<\/li>\n<\/ul>\n<pre class=\"wp-block-code\" aria-describedby=\"shcb-language-2\" data-shcb-language-name=\"YAML\" data-shcb-language-slug=\"yaml\"><span><code class=\"hljs language-yaml shcb-code-table shcb-line-numbers shcb-wrap-lines\"><span class='shcb-loc'><span><span class=\"hljs-attr\">PAPERLESS_OCR_LANGUAGE:<\/span> <span class=\"hljs-string\">deu+eng<\/span>\n<\/span><\/span><\/code><\/span><small class=\"shcb-language\" id=\"shcb-language-2\"><span class=\"shcb-language__label\">Code language:<\/span> <span class=\"shcb-language__name\">YAML<\/span> <span class=\"shcb-language__paren\">(<\/span><span class=\"shcb-language__slug\">yaml<\/span><span class=\"shcb-language__paren\">)<\/span><\/small><\/pre>\n<ul class=\"wp-block-list\">\n<li>Test: upload a PDF with clearly readable text and search specifically for a word.<\/li>\n<\/ul>\n\n<p class=\"wp-block-paragraph\">\u27a1\ufe0f Paperless itself may be running correctly, but OCR is only as good as the input data.<\/p>\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n<h2 class=\"wp-block-heading\">Containers Are Running, but the Web UI Is Not Reachable<\/h2>\n\n<p class=\"wp-block-paragraph\"><strong>Possible causes:<\/strong><\/p>\n\n<ul class=\"wp-block-list\">\n<li>port already in use<\/li>\n\n\n\n<li>incorrect port mapping<\/li>\n\n\n\n<li>container is not running reliably<\/li>\n<\/ul>\n\n<p class=\"wp-block-paragraph\"><strong>Checks:<\/strong><\/p>\n<pre class=\"wp-block-code\" aria-describedby=\"shcb-language-3\" data-shcb-language-name=\"Bash\" data-shcb-language-slug=\"bash\"><span><code class=\"hljs language-bash shcb-code-table shcb-line-numbers shcb-wrap-lines\"><span class='shcb-loc'><span>docker compose ps\n<\/span><\/span><span class='shcb-loc'><span>docker compose logs paperless\n<\/span><\/span><\/code><\/span><small class=\"shcb-language\" id=\"shcb-language-3\"><span class=\"shcb-language__label\">Code language:<\/span> <span class=\"shcb-language__name\">Bash<\/span> <span class=\"shcb-language__paren\">(<\/span><span class=\"shcb-language__slug\">bash<\/span><span class=\"shcb-language__paren\">)<\/span><\/small><\/pre>\n<p class=\"wp-block-paragraph\">\u27a1\ufe0f Alternatively, try a different port, for example <code>8080:8000.<\/code><\/p>\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n<h2 class=\"wp-block-heading\">PostgreSQL Errors or Paperless Loses Its Database Connection<\/h2>\n\n<p class=\"wp-block-paragraph\"><strong>Possible causes:<\/strong><\/p>\n\n<ul class=\"wp-block-list\">\n<li>database not yet initialised<\/li>\n\n\n\n<li>volume damaged or empty<\/li>\n\n\n\n<li>credentials inconsistent<\/li>\n<\/ul>\n\n<p class=\"wp-block-paragraph\"><strong>Checks:<\/strong><\/p>\n<pre class=\"wp-block-code\" aria-describedby=\"shcb-language-4\" data-shcb-language-name=\"Bash\" data-shcb-language-slug=\"bash\"><span><code class=\"hljs language-bash shcb-code-table shcb-line-numbers shcb-wrap-lines\"><span class='shcb-loc'><span>docker compose logs db\n<\/span><\/span><span class='shcb-loc'><span>docker <span class=\"hljs-built_in\">exec<\/span> -it paperless-db psql -U paperless -d paperless\n<\/span><\/span><\/code><\/span><small class=\"shcb-language\" id=\"shcb-language-4\"><span class=\"shcb-language__label\">Code language:<\/span> <span class=\"shcb-language__name\">Bash<\/span> <span class=\"shcb-language__paren\">(<\/span><span class=\"shcb-language__slug\">bash<\/span><span class=\"shcb-language__paren\">)<\/span><\/small><\/pre>\n<p class=\"wp-block-paragraph\">\u27a1\ufe0f If necessary, stop the containers cleanly and restart them (do not delete volumes immediately).<\/p>\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n<h2 class=\"wp-block-heading\">Paperless Is Running but Responds Slowly or with Delays<\/h2>\n\n<p class=\"wp-block-paragraph\"><strong>Possible causes:<\/strong><\/p>\n\n<ul class=\"wp-block-list\">\n<li>not enough RAM<\/li>\n\n\n\n<li>slow storage<\/li>\n\n\n\n<li>OCR processing too many documents at once<\/li>\n<\/ul>\n\n<p class=\"wp-block-paragraph\"><strong>Checks:<\/strong><\/p>\n<pre class=\"wp-block-code\" aria-describedby=\"shcb-language-5\" data-shcb-language-name=\"Bash\" data-shcb-language-slug=\"bash\"><span><code class=\"hljs language-bash shcb-code-table shcb-line-numbers shcb-wrap-lines\"><span class='shcb-loc'><span>docker stats\n<\/span><\/span><\/code><\/span><small class=\"shcb-language\" id=\"shcb-language-5\"><span class=\"shcb-language__label\">Code language:<\/span> <span class=\"shcb-language__name\">Bash<\/span> <span class=\"shcb-language__paren\">(<\/span><span class=\"shcb-language__slug\">bash<\/span><span class=\"shcb-language__paren\">)<\/span><\/small><\/pre>\n<p class=\"wp-block-paragraph\">\u27a1\ufe0f On smaller systems such as a NAS or Raspberry Pi, it is advisable to import large batches of documents in stages.<\/p>\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n<h2 class=\"wp-block-heading\">Documents in the Consume Folder Are Processed Only When the Container Starts (NFS)<\/h2>\n\n<p class=\"wp-block-paragraph\"><strong>Symptom:<\/strong><\/p>\n\n<ul class=\"wp-block-list\">\n<li>Documents are imported <strong>only when the container starts<\/strong>.<\/li>\n\n\n\n<li>New files in the consume folder are <strong>not detected automatically<\/strong>.<\/li>\n<\/ul>\n\n<p class=\"wp-block-paragraph\">This behaviour typically occurs when the consume folder is mounted via <strong>NFS<\/strong>.<\/p>\n\n<p class=\"wp-block-paragraph\"><strong>Cause:<\/strong> Paperless-NGX uses <strong>Inotify<\/strong> by default to detect filesystem events.<br\/>With NFS mounts, however, these events are <strong>not reliably passed to the container, or not passed at all<\/strong>.<\/p>\n\n<p class=\"wp-block-paragraph\">This is not a Paperless error, but a technical limitation of NFS in combination with Inotify.<\/p>\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n<h3 class=\"wp-block-heading\">Solution: Enable Polling for the Consume Folder<\/h3>\n\n<p class=\"wp-block-paragraph\">In this case, <strong>polling<\/strong> should be enabled.<br\/>Paperless then actively checks at regular intervals whether new files are present in the consume folder.<\/p>\n\n<h4 class=\"wp-block-heading\">Setting in docker-compose.yml<\/h4>\n<pre class=\"wp-block-code\" aria-describedby=\"shcb-language-6\" data-shcb-language-name=\"YAML\" data-shcb-language-slug=\"yaml\"><span><code class=\"hljs language-yaml shcb-code-table shcb-line-numbers shcb-wrap-lines\"><span class='shcb-loc'><span><span class=\"hljs-attr\">environment:<\/span>\n<\/span><\/span><span class='shcb-loc'><span>  <span class=\"hljs-attr\">PAPERLESS_CONSUMER_POLLING:<\/span> <span class=\"hljs-string\">\"5\"<\/span>\n<\/span><\/span><\/code><\/span><small class=\"shcb-language\" id=\"shcb-language-6\"><span class=\"shcb-language__label\">Code language:<\/span> <span class=\"shcb-language__name\">YAML<\/span> <span class=\"shcb-language__paren\">(<\/span><span class=\"shcb-language__slug\">yaml<\/span><span class=\"shcb-language__paren\">)<\/span><\/small><\/pre>\n<p class=\"wp-block-paragraph\">The value specifies the interval in <strong>seconds<\/strong> at which Paperless checks the consume folder.<\/p>\n\n<p class=\"wp-block-paragraph\"><strong>Proven values in practice:<\/strong><\/p>\n\n<ul class=\"wp-block-list\">\n<li><code>5<\/code> seconds \u2192 very reliable, minimal overhead<\/li>\n\n\n\n<li><code>10\u201330<\/code> seconds \u2192 sufficient for most setups<\/li>\n<\/ul>\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n<h4 class=\"wp-block-heading\">When Is Polling Useful?<\/h4>\n\n<p class=\"wp-block-paragraph\">Polling should be enabled when:<\/p>\n\n<ul class=\"wp-block-list\">\n<li>the consume folder is mounted via <strong>NFS<\/strong><\/li>\n\n\n\n<li>external systems (scanners, Drive, sync tools) place files there<\/li>\n\n\n\n<li>importing works only when the container starts<\/li>\n<\/ul>\n\n<p class=\"wp-block-paragraph\">Polling is <strong>not a workaround<\/strong>; it is the <strong>recommended operating mode<\/strong> for NFS-based consume directories.<\/p>\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n<h4 class=\"wp-block-heading\">When Is Polling Not Necessary?<\/h4>\n\n<p class=\"wp-block-paragraph\">Polling is usually not required when:<\/p>\n\n<ul class=\"wp-block-list\">\n<li>the consume folder is mounted locally<\/li>\n\n\n\n<li>no network filesystems are involved<\/li>\n\n\n\n<li>Inotify reliably delivers events<\/li>\n<\/ul>\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n<h3 class=\"wp-block-heading\">Conclusion on NFS &amp; Consume Processing<\/h3>\n\n<p class=\"wp-block-paragraph\">When Paperless-NGX uses NFS, you should <strong>not<\/strong> expect Inotify \u2013 the event-based mechanism for immediately importing documents from the scan folder \u2013 to work reliably. Enabling polling provides:<\/p>\n\n<ul class=\"wp-block-list\">\n<li>deterministic behaviour<\/li>\n\n\n\n<li>stable imports<\/li>\n\n\n\n<li>traceable processing<\/li>\n<\/ul>\n\n<p class=\"wp-block-paragraph\">Especially in combination with NAS systems, polling is the <strong>more robust and less troublesome solution<\/strong>.<\/p>\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n<h2 class=\"wp-block-heading\">Documents Are Imported Multiple Times<\/h2>\n\n<p class=\"wp-block-paragraph\"><strong>Possible causes:<\/strong><\/p>\n\n<ul class=\"wp-block-list\">\n<li>documents remain in the consume directory<\/li>\n\n\n\n<li>scanner copies files instead of moving them<\/li>\n\n\n\n<li>an external sync process accesses them in parallel<\/li>\n<\/ul>\n\n<p class=\"wp-block-paragraph\"><strong>Checks:<\/strong><\/p>\n\n<ul class=\"wp-block-list\">\n<li>check the consume directory after import<\/li>\n\n\n\n<li>configure the scanner to \u201cMove\u201d rather than \u201cCopy\u201d files<\/li>\n<\/ul>\n\n<p class=\"wp-block-paragraph\">\u27a1\ufe0f The consume folder should be used as a <strong>pure inbox<\/strong>, not as storage.<\/p>\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n<h2 class=\"wp-block-heading\">Users Can Log In but Cannot See Any Documents<\/h2>\n\n<p class=\"wp-block-paragraph\"><strong>Possible causes:<\/strong><\/p>\n\n<ul class=\"wp-block-list\">\n<li>permissions\/role concept not configured correctly<\/li>\n\n\n\n<li>documents are assigned to other users<\/li>\n<\/ul>\n\n<p class=\"wp-block-paragraph\"><strong>Checks:<\/strong><\/p>\n\n<ul class=\"wp-block-list\">\n<li>review user roles in the settings<\/li>\n\n\n\n<li>temporarily grant administrator permissions for testing<\/li>\n<\/ul>\n\n<p class=\"wp-block-paragraph\">\u27a1\ufe0f Paperless is fully multi-user capable \u2013 visibility can deliberately be controlled.<\/p>\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n<h2 class=\"wp-block-heading\">When Is a Complete Rebuild Worthwhile?<\/h2>\n\n<p class=\"wp-block-paragraph\">A complete rebuild is usually <strong>not necessary<\/strong> if:<\/p>\n\n<ul class=\"wp-block-list\">\n<li>containers start cleanly<\/li>\n\n\n\n<li>logs show understandable errors<\/li>\n\n\n\n<li>data directories are intact<\/li>\n<\/ul>\n\n<p class=\"wp-block-paragraph\">A rebuild is more appropriate in cases of:<\/p>\n\n<ul class=\"wp-block-list\">\n<li>faulty volumes<\/li>\n\n\n\n<li>multiple experimental configuration changes<\/li>\n\n\n\n<li>fundamental architectural changes<\/li>\n<\/ul>\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n<h3 class=\"wp-block-heading has-text-align-center has-medium-font-size\">More Articles About Paperless-ngx<\/h3>\n\n<ul class=\"wp-block-list\">\n<li><a href=\"https:\/\/michael-hoepfl.com\/en\/technology\/what-paperless-ngx-really-delivers-in-everyday-use\/01-2026\/\">What Paperless-NGX Really Delivers in Everyday Use<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/michael-hoepfl.com\/technologie\/paperless-ngx-installieren-voraussetzungen-betriebsmodelle-und-der-weg-zur-lauffaehigen-installation\/01-2026\/\">Installing Paperless-NGX: Requirements, Deployment Models and the Path to a Working Installation<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/michael-hoepfl.com\/technologie\/paperless-ngx-auf-synology-nfs-mounts-saubere-drive-integration-und-ein-stabiles-docker-setup\/01-2026\/\">Paperless-NGX on Synology: NFS Mounts, Clean Drive Integration and a Stable Docker Setup<\/a><\/li>\n<\/ul>\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n","protected":false},"excerpt":{"rendered":"<p>Paperless-ngx is running but not importing documents? OCR returns empty results or the consume folder remains silent? This article brings together the most common practical pitfalls and provides quick checks [&hellip;]<\/p>\n","protected":false},"author":4,"featured_media":4989,"comment_status":"closed","ping_status":"open","sticky":true,"template":"","format":"standard","meta":{"_import_markdown_pro_load_document_selector":0,"_import_markdown_pro_submit_text_textarea":"","_jetpack_newsletter_access":"","_jetpack_dont_email_post_to_subs":false,"_jetpack_newsletter_tier_id":0,"_jetpack_memberships_contains_paywalled_content":false,"_jetpack_feature_clip_id":0,"_jetpack_memberships_contains_paid_content":false,"footnotes":"","jetpack_post_was_ever_published":false},"categories":[287],"tags":[293,309,308,297,312,311,292,298,291,310],"class_list":["post-4988","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-technology","tag-docker","tag-docker-compose","tag-how-to","tag-linux","tag-nfs","tag-ocr","tag-paperless","tag-self-hosting","tag-synology","tag-troubleshooting","bwp-blog-post","bwp-masonry-item","bwp-col-1","bwp-post-has-title"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v28.2 - https:\/\/yoast.com\/product\/yoast-seo-wordpress\/ -->\n<title>Paperless-ngx Troubleshooting \u2013 Fix Common Problems Quickly<\/title>\n<meta name=\"description\" content=\"Paperless-ngx is running but not importing documents? This guide covers common causes and helps you resolve problems quickly.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/michael-hoepfl.com\/en\/technology\/paperless-ngx-troubleshooting-common-pitfalls-and-quick-checks\/01-2026\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Paperless-ngx Troubleshooting \u2013 Fix Common Problems Quickly\" \/>\n<meta property=\"og:description\" content=\"Paperless-ngx is running but not importing documents? This guide covers common causes and helps you resolve problems quickly.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/michael-hoepfl.com\/en\/technology\/paperless-ngx-troubleshooting-common-pitfalls-and-quick-checks\/01-2026\/\" \/>\n<meta property=\"og:site_name\" content=\"michael-hoepfl.com\" \/>\n<meta property=\"article:published_time\" content=\"2026-01-12T22:30:24+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2026-08-11T12:21:59+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/michael-hoepfl.com\/wp-content\/uploads\/2026\/01\/paperless-ngx-self-hosted-inputs-architecture.png\" \/>\n\t<meta property=\"og:image:width\" content=\"1331\" \/>\n\t<meta property=\"og:image:height\" content=\"677\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/png\" \/>\n<meta name=\"author\" content=\"Michael H\u00f6pfl\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Michael H\u00f6pfl\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"4 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\\\/\\\/michael-hoepfl.com\\\/en\\\/technology\\\/paperless-ngx-troubleshooting-common-pitfalls-and-quick-checks\\\/01-2026\\\/#article\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/michael-hoepfl.com\\\/en\\\/technology\\\/paperless-ngx-troubleshooting-common-pitfalls-and-quick-checks\\\/01-2026\\\/\"},\"author\":{\"name\":\"Michael H\u00f6pfl\",\"@id\":\"https:\\\/\\\/michael-hoepfl.com\\\/en\\\/#\\\/schema\\\/person\\\/8d843bca28bfc5f703bcf977868eb8d7\"},\"headline\":\"Paperless-NGX Troubleshooting \u2013 Common Pitfalls and Quick Checks\",\"datePublished\":\"2026-01-12T22:30:24+00:00\",\"dateModified\":\"2026-08-11T12:21:59+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\\\/\\\/michael-hoepfl.com\\\/en\\\/technology\\\/paperless-ngx-troubleshooting-common-pitfalls-and-quick-checks\\\/01-2026\\\/\"},\"wordCount\":762,\"publisher\":{\"@id\":\"https:\\\/\\\/michael-hoepfl.com\\\/en\\\/#\\\/schema\\\/person\\\/8d843bca28bfc5f703bcf977868eb8d7\"},\"image\":{\"@id\":\"https:\\\/\\\/michael-hoepfl.com\\\/en\\\/technology\\\/paperless-ngx-troubleshooting-common-pitfalls-and-quick-checks\\\/01-2026\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/michael-hoepfl.com\\\/wp-content\\\/uploads\\\/2026\\\/01\\\/paperless-ngx-self-hosted-inputs-architecture.png\",\"keywords\":[\"Docker\",\"Docker Compose\",\"How-to\",\"Linux\",\"NFS\",\"OCR\",\"Paperless\",\"Self-Hosting\",\"Synology\",\"Troubleshooting\"],\"articleSection\":[\"Technology\"],\"inLanguage\":\"en-US\"},{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/michael-hoepfl.com\\\/en\\\/technology\\\/paperless-ngx-troubleshooting-common-pitfalls-and-quick-checks\\\/01-2026\\\/\",\"url\":\"https:\\\/\\\/michael-hoepfl.com\\\/en\\\/technology\\\/paperless-ngx-troubleshooting-common-pitfalls-and-quick-checks\\\/01-2026\\\/\",\"name\":\"Paperless-ngx Troubleshooting \u2013 Fix Common Problems Quickly\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/michael-hoepfl.com\\\/en\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/michael-hoepfl.com\\\/en\\\/technology\\\/paperless-ngx-troubleshooting-common-pitfalls-and-quick-checks\\\/01-2026\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/michael-hoepfl.com\\\/en\\\/technology\\\/paperless-ngx-troubleshooting-common-pitfalls-and-quick-checks\\\/01-2026\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/michael-hoepfl.com\\\/wp-content\\\/uploads\\\/2026\\\/01\\\/paperless-ngx-self-hosted-inputs-architecture.png\",\"datePublished\":\"2026-01-12T22:30:24+00:00\",\"dateModified\":\"2026-08-11T12:21:59+00:00\",\"description\":\"Paperless-ngx is running but not importing documents? This guide covers common causes and helps you resolve problems quickly.\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/michael-hoepfl.com\\\/en\\\/technology\\\/paperless-ngx-troubleshooting-common-pitfalls-and-quick-checks\\\/01-2026\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/michael-hoepfl.com\\\/en\\\/technology\\\/paperless-ngx-troubleshooting-common-pitfalls-and-quick-checks\\\/01-2026\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/michael-hoepfl.com\\\/en\\\/technology\\\/paperless-ngx-troubleshooting-common-pitfalls-and-quick-checks\\\/01-2026\\\/#primaryimage\",\"url\":\"https:\\\/\\\/michael-hoepfl.com\\\/wp-content\\\/uploads\\\/2026\\\/01\\\/paperless-ngx-self-hosted-inputs-architecture.png\",\"contentUrl\":\"https:\\\/\\\/michael-hoepfl.com\\\/wp-content\\\/uploads\\\/2026\\\/01\\\/paperless-ngx-self-hosted-inputs-architecture.png\",\"width\":1331,\"height\":677,\"caption\":\"Self-hosted Paperless-NGX system with document import via scanner, email and smartphone\"},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/michael-hoepfl.com\\\/en\\\/technology\\\/paperless-ngx-troubleshooting-common-pitfalls-and-quick-checks\\\/01-2026\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Startseite\",\"item\":\"https:\\\/\\\/michael-hoepfl.com\\\/en\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Paperless-NGX Troubleshooting \u2013 Common Pitfalls and Quick Checks\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/michael-hoepfl.com\\\/en\\\/#website\",\"url\":\"https:\\\/\\\/michael-hoepfl.com\\\/en\\\/\",\"name\":\"michael-hoepfl.com\",\"description\":\"my business. my brain stuff. my blog.\",\"publisher\":{\"@id\":\"https:\\\/\\\/michael-hoepfl.com\\\/en\\\/#\\\/schema\\\/person\\\/8d843bca28bfc5f703bcf977868eb8d7\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/michael-hoepfl.com\\\/en\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":[\"Person\",\"Organization\"],\"@id\":\"https:\\\/\\\/michael-hoepfl.com\\\/en\\\/#\\\/schema\\\/person\\\/8d843bca28bfc5f703bcf977868eb8d7\",\"name\":\"Michael H\u00f6pfl\",\"pronouns\":\"er\\\/ihr\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/michael-hoepfl.com\\\/wp-content\\\/uploads\\\/2026\\\/08\\\/LinkedIn-Profile-Image-2026-1024x1024.png\",\"url\":\"https:\\\/\\\/michael-hoepfl.com\\\/wp-content\\\/uploads\\\/2026\\\/08\\\/LinkedIn-Profile-Image-2026-1024x1024.png\",\"contentUrl\":\"https:\\\/\\\/michael-hoepfl.com\\\/wp-content\\\/uploads\\\/2026\\\/08\\\/LinkedIn-Profile-Image-2026-1024x1024.png\",\"width\":1024,\"height\":1024,\"caption\":\"Michael H\u00f6pfl\"},\"logo\":{\"@id\":\"https:\\\/\\\/michael-hoepfl.com\\\/wp-content\\\/uploads\\\/2026\\\/08\\\/LinkedIn-Profile-Image-2026-1024x1024.png\"},\"description\":\"Ich schreibe und poste hier zu Themen, die mich seit jeher privat als auch beruflich interessieren und begleiten. [Mehr \u00fcber mich]\",\"sameAs\":[\"https:\\\/\\\/michael-hoepfl.com\",\"https:\\\/\\\/www.linkedin.com\\\/in\\\/michael-hoepfl\"],\"url\":\"https:\\\/\\\/michael-hoepfl.com\\\/en\\\/author\\\/mhoepfl\\\/\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Paperless-ngx Troubleshooting \u2013 Fix Common Problems Quickly","description":"Paperless-ngx is running but not importing documents? This guide covers common causes and helps you resolve problems quickly.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/michael-hoepfl.com\/en\/technology\/paperless-ngx-troubleshooting-common-pitfalls-and-quick-checks\/01-2026\/","og_locale":"en_US","og_type":"article","og_title":"Paperless-ngx Troubleshooting \u2013 Fix Common Problems Quickly","og_description":"Paperless-ngx is running but not importing documents? This guide covers common causes and helps you resolve problems quickly.","og_url":"https:\/\/michael-hoepfl.com\/en\/technology\/paperless-ngx-troubleshooting-common-pitfalls-and-quick-checks\/01-2026\/","og_site_name":"michael-hoepfl.com","article_published_time":"2026-01-12T22:30:24+00:00","article_modified_time":"2026-08-11T12:21:59+00:00","og_image":[{"width":1331,"height":677,"url":"https:\/\/michael-hoepfl.com\/wp-content\/uploads\/2026\/01\/paperless-ngx-self-hosted-inputs-architecture.png","type":"image\/png"}],"author":"Michael H\u00f6pfl","twitter_card":"summary_large_image","twitter_misc":{"Written by":"Michael H\u00f6pfl","Est. reading time":"4 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/michael-hoepfl.com\/en\/technology\/paperless-ngx-troubleshooting-common-pitfalls-and-quick-checks\/01-2026\/#article","isPartOf":{"@id":"https:\/\/michael-hoepfl.com\/en\/technology\/paperless-ngx-troubleshooting-common-pitfalls-and-quick-checks\/01-2026\/"},"author":{"name":"Michael H\u00f6pfl","@id":"https:\/\/michael-hoepfl.com\/en\/#\/schema\/person\/8d843bca28bfc5f703bcf977868eb8d7"},"headline":"Paperless-NGX Troubleshooting \u2013 Common Pitfalls and Quick Checks","datePublished":"2026-01-12T22:30:24+00:00","dateModified":"2026-08-11T12:21:59+00:00","mainEntityOfPage":{"@id":"https:\/\/michael-hoepfl.com\/en\/technology\/paperless-ngx-troubleshooting-common-pitfalls-and-quick-checks\/01-2026\/"},"wordCount":762,"publisher":{"@id":"https:\/\/michael-hoepfl.com\/en\/#\/schema\/person\/8d843bca28bfc5f703bcf977868eb8d7"},"image":{"@id":"https:\/\/michael-hoepfl.com\/en\/technology\/paperless-ngx-troubleshooting-common-pitfalls-and-quick-checks\/01-2026\/#primaryimage"},"thumbnailUrl":"https:\/\/michael-hoepfl.com\/wp-content\/uploads\/2026\/01\/paperless-ngx-self-hosted-inputs-architecture.png","keywords":["Docker","Docker Compose","How-to","Linux","NFS","OCR","Paperless","Self-Hosting","Synology","Troubleshooting"],"articleSection":["Technology"],"inLanguage":"en-US"},{"@type":"WebPage","@id":"https:\/\/michael-hoepfl.com\/en\/technology\/paperless-ngx-troubleshooting-common-pitfalls-and-quick-checks\/01-2026\/","url":"https:\/\/michael-hoepfl.com\/en\/technology\/paperless-ngx-troubleshooting-common-pitfalls-and-quick-checks\/01-2026\/","name":"Paperless-ngx Troubleshooting \u2013 Fix Common Problems Quickly","isPartOf":{"@id":"https:\/\/michael-hoepfl.com\/en\/#website"},"primaryImageOfPage":{"@id":"https:\/\/michael-hoepfl.com\/en\/technology\/paperless-ngx-troubleshooting-common-pitfalls-and-quick-checks\/01-2026\/#primaryimage"},"image":{"@id":"https:\/\/michael-hoepfl.com\/en\/technology\/paperless-ngx-troubleshooting-common-pitfalls-and-quick-checks\/01-2026\/#primaryimage"},"thumbnailUrl":"https:\/\/michael-hoepfl.com\/wp-content\/uploads\/2026\/01\/paperless-ngx-self-hosted-inputs-architecture.png","datePublished":"2026-01-12T22:30:24+00:00","dateModified":"2026-08-11T12:21:59+00:00","description":"Paperless-ngx is running but not importing documents? This guide covers common causes and helps you resolve problems quickly.","breadcrumb":{"@id":"https:\/\/michael-hoepfl.com\/en\/technology\/paperless-ngx-troubleshooting-common-pitfalls-and-quick-checks\/01-2026\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/michael-hoepfl.com\/en\/technology\/paperless-ngx-troubleshooting-common-pitfalls-and-quick-checks\/01-2026\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/michael-hoepfl.com\/en\/technology\/paperless-ngx-troubleshooting-common-pitfalls-and-quick-checks\/01-2026\/#primaryimage","url":"https:\/\/michael-hoepfl.com\/wp-content\/uploads\/2026\/01\/paperless-ngx-self-hosted-inputs-architecture.png","contentUrl":"https:\/\/michael-hoepfl.com\/wp-content\/uploads\/2026\/01\/paperless-ngx-self-hosted-inputs-architecture.png","width":1331,"height":677,"caption":"Self-hosted Paperless-NGX system with document import via scanner, email and smartphone"},{"@type":"BreadcrumbList","@id":"https:\/\/michael-hoepfl.com\/en\/technology\/paperless-ngx-troubleshooting-common-pitfalls-and-quick-checks\/01-2026\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Startseite","item":"https:\/\/michael-hoepfl.com\/en\/"},{"@type":"ListItem","position":2,"name":"Paperless-NGX Troubleshooting \u2013 Common Pitfalls and Quick Checks"}]},{"@type":"WebSite","@id":"https:\/\/michael-hoepfl.com\/en\/#website","url":"https:\/\/michael-hoepfl.com\/en\/","name":"michael-hoepfl.com","description":"my business. my brain stuff. my blog.","publisher":{"@id":"https:\/\/michael-hoepfl.com\/en\/#\/schema\/person\/8d843bca28bfc5f703bcf977868eb8d7"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/michael-hoepfl.com\/en\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":["Person","Organization"],"@id":"https:\/\/michael-hoepfl.com\/en\/#\/schema\/person\/8d843bca28bfc5f703bcf977868eb8d7","name":"Michael H\u00f6pfl","pronouns":"er\/ihr","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/michael-hoepfl.com\/wp-content\/uploads\/2026\/08\/LinkedIn-Profile-Image-2026-1024x1024.png","url":"https:\/\/michael-hoepfl.com\/wp-content\/uploads\/2026\/08\/LinkedIn-Profile-Image-2026-1024x1024.png","contentUrl":"https:\/\/michael-hoepfl.com\/wp-content\/uploads\/2026\/08\/LinkedIn-Profile-Image-2026-1024x1024.png","width":1024,"height":1024,"caption":"Michael H\u00f6pfl"},"logo":{"@id":"https:\/\/michael-hoepfl.com\/wp-content\/uploads\/2026\/08\/LinkedIn-Profile-Image-2026-1024x1024.png"},"description":"Ich schreibe und poste hier zu Themen, die mich seit jeher privat als auch beruflich interessieren und begleiten. [Mehr \u00fcber mich]","sameAs":["https:\/\/michael-hoepfl.com","https:\/\/www.linkedin.com\/in\/michael-hoepfl"],"url":"https:\/\/michael-hoepfl.com\/en\/author\/mhoepfl\/"}]}},"jetpack_sharing_enabled":true,"jetpack_featured_media_url":"https:\/\/michael-hoepfl.com\/wp-content\/uploads\/2026\/01\/paperless-ngx-self-hosted-inputs-architecture.png","_links":{"self":[{"href":"https:\/\/michael-hoepfl.com\/en\/wp-json\/wp\/v2\/posts\/4988","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/michael-hoepfl.com\/en\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/michael-hoepfl.com\/en\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/michael-hoepfl.com\/en\/wp-json\/wp\/v2\/users\/4"}],"replies":[{"embeddable":true,"href":"https:\/\/michael-hoepfl.com\/en\/wp-json\/wp\/v2\/comments?post=4988"}],"version-history":[{"count":1,"href":"https:\/\/michael-hoepfl.com\/en\/wp-json\/wp\/v2\/posts\/4988\/revisions"}],"predecessor-version":[{"id":4990,"href":"https:\/\/michael-hoepfl.com\/en\/wp-json\/wp\/v2\/posts\/4988\/revisions\/4990"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/michael-hoepfl.com\/en\/wp-json\/wp\/v2\/media\/4989"}],"wp:attachment":[{"href":"https:\/\/michael-hoepfl.com\/en\/wp-json\/wp\/v2\/media?parent=4988"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/michael-hoepfl.com\/en\/wp-json\/wp\/v2\/categories?post=4988"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/michael-hoepfl.com\/en\/wp-json\/wp\/v2\/tags?post=4988"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}