Paperless-NGX PDF & Installationsdaten auf unterschiedlichen Volumen installieren

Panteran · October 18, 2025 at 11:58 PM

Hallo zusammen,
es gibt zwar schon reichlich Titel über das Thema Paperless. Aber speziel für das Problem habe ich nichts gefunden.
Ich habe docker auf der NVME auf Volumen 2 laufen. Ich möchte aber die PDF Daten auf den HDD's in Volume1 speichern lassen.

Die Yml habe ich entsprechend abgeändert.

YAML

services:
broker:
image: redis
container_name: paperless-ngx-redis
restart: unless-stopped
volumes:
- /volume2/docker/paperless-ngx/redis:/data
db:
image: postgres:17.4
container_name: paperless-ngx-db
restart: unless-stopped
volumes:
- /volume2/docker/paperless-ngx/db:/var/lib/postgresql/data
environment:
POSTGRES_DB: paperlessdb
POSTGRES_USER: .............
POSTGRES_PASSWORD: ................
webserver:
image: ghcr.io/paperless-ngx/paperless-ngx:2.14.7 (habe auch schon 2.18.4 getestet)
container_name: paperless-ngx
restart: unless-stopped
depends_on:
- db
- broker 
ports:
- "8000:8000"
volumes:
- /volume2/docker/paperless-ngx/data:/usr/src/paperless/data
- /volume1/Brother Scan/media:/usr/src/paperless/media
- /volume1/Brother Scan/export:/usr/src/paperless/export
- /volume1/Brother Scan/consume:/usr/src/paperless/consume
env_file: docker-compose.env
environment:
PAPERLESS_REDIS: redis://broker:6379
PAPERLESS_DBHOST: db
PAPERLESS_USERMAP_UID: ........
PAPERLESS_USERMAP_GID: .....

Display More

gotenberg und Tika benötige ich nicht.

Über SSH habe ich die UiD und Gid abgeglichen und auch in der env geändert und in die yml eingetragen .

Er legt auch alles schön an, die Container laufen alle, aber es ist über die IP nicht erreichbar. (Wenn ich alle Ordner in Volume2 auf der NVME erstellen lasse startet Paperless und ist auch erreichbar)

Das steht im Protokoll:

Code

Running migrations:
paperless-ngx | Applying auditlog.0016_logentry_remote_port... OK
paperless-ngx | Applying auditlog.0017_add_actor_email... OK
paperless-ngx | Applying django_celery_results.0012_taskresult_date_started... OK
paperless-ngx | Applying django_celery_results.0013_taskresult_django_cele_periodi_1993cf_idx... OK
paperless-ngx | Applying django_celery_results.0014_alter_taskresult_status... OK
paperless-ngx | Applying documents.1062_alter_savedviewfilterrule_rule_type... OK
paperless-ngx | Applying documents.1063_paperlesstask_type_alter_paperlesstask_task_name_and_more... OK
paperless-ngx | Applying documents.1064_delete_log... OK
paperless-ngx | Applying documents.1065_workflowaction_assign_custom_fields_values... OK
paperless-ngx | Applying documents.1066_alter_workflowtrigger_schedule_offset_days... OK
paperless-ngx | Applying documents.1067_alter_document_created... OK
paperless-ngx | Applying documents.1068_alter_document_created... OK
paperless-ngx | Applying paperless.0004_applicationconfiguration_barcode_asn_prefix_and_more... OK
paperless-ngx | Applying paperless_mail.0029_mailrule_pdf_layout... OK
paperless-ngx | [init-superuser] Creating superuser...
paperless-ngx | Did not create superuser, a user XXXX already exists
paperless-ngx | [init-superuser] Superuser creation done
paperless-ngx | [init-checks] Running Django checks
paperless-ngx | System check identified no issues (0 silenced).
paperless-ngx | [custom-init] /custom-cont-init.d doesn't exist, nothing to do
paperless-ngx | [init-complete] paperless-ngx docker container init completed in 17 seconds
paperless-ngx | [init-complete] Starting services
paperless-ngx | [svc-flower] Checking if we should start flower...
paperless-ngx | [svc-flower] Not starting flower
paperless-ngx | [INFO] Starting granian (main PID: 185)

paperless-ngx | [INFO] Listening at: http://:::8000
paperless-ngx | [INFO] Spawning worker-1 with PID: 205
paperless-ngx | celery beat v5.5.3 (immunity) is starting.
paperless-ngx | 
paperless-ngx | -------------- celery@89ebd384530f v5.5.3 (immunity)
paperless-ngx | --- ***** ----- 
paperless-ngx | -- ******* ---- Linux-6.12.30+-x86_64-with-glibc2.36 2025-10-18 23:39:39
paperless-ngx | - *** --- * --- 
paperless-ngx | - ** ---------- [config]
paperless-ngx | - ** ---------- .> app: paperless:0x7fcacae87da0

paperless-ngx | - ** ---------- .> transport: redis://broker:6379//
paperless-ngx | - ** ---------- .> results:
paperless-ngx | - *** --- * --- .> concurrency: 1 (prefork)
paperless-ngx | -- ******* ---- .> task events: ON
paperless-ngx | --- ***** ----- 
paperless-ngx | -------------- [queues]
paperless-ngx | .> celery exchange=celery(direct) key=celery
paperless-ngx | 
paperless-ngx | 
paperless-ngx | [tasks]
paperless-ngx | . documents.bulk_edit.delete
paperless-ngx | . documents.signals.handlers.send_webhook
paperless-ngx | . documents.tasks.bulk_update_documents
paperless-ngx | . documents.tasks.check_scheduled_workflows
paperless-ngx | . documents.tasks.consume_file
paperless-ngx | . documents.tasks.empty_trash
paperless-ngx | . documents.tasks.index_op
timize
paperless-ngx | . documents.tasks.sanity_check
paperless-ngx | . documents.tasks.train_classifier
paperless-ngx | . documents.tasks.update_document_content_maybe_archive_file
paperless-ngx | . paperless_mail.mail.apply_mail_action
paperless-ngx | . paperless_mail.mail.error_callback
paperless-ngx | . paperless_mail.tasks.process_mail_accounts
paperless-ngx |
paperless-ngx | [2025-10-18 23:39:39,588] [INFO] [celery.worker.consumer.connection] Connected to redis://broker:6379//
paperless-ngx | [2025-10-18 23:39:39,600] [INFO] [celery.apps.worker] celery@89ebd384530f ready.
paperless-ngx | [2025-10-18 23:39:40,360] [INFO] [paperless.management.consumer] Using inotify to watch directory for changes: /usr/src/paperless/consume
paperless-ngx | Traceback (most recent call last):
paperless-ngx | File "/usr/src/paperless/src/manage.py", line 10, in <module>
paperless-ngx | execute_from_command_line(sys.argv)
paperless-ngx | File "/usr/local/lib/python3.12/site-packages/django/core/management/__init__.py", line 442, in execute_from_command_line
paperless-ngx | utility.execute()
paperless-ngx | File "/usr/local/lib/python3.12/site-packages/django/core/management/__init__.py", line 436, in execute
paperless-ngx | self.fetch_command(subcommand).run_from_argv(self.argv)
paperless-ngx | File "/usr/local/lib/python3.12/site-packages/django/core/management/base.py", line 416, in run_from_argv
paperless-ngx | self.execute(*args, **cmd_options)
paperless-ngx | File "/usr/local/lib/python3.12/site-packages/django/core/management/base.py", line 460, in execute
paperless-ngx | output = self.handle(*args, **options)
paperless-ngx | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
paperless-ngx | File "/usr/src/paperless/src/documents/management/commands/document_consumer.py", line 247, in handle
paperless-ngx | self.handle_inotify(directory, recursive, is_testing=options["testing"])
paperless-ngx | File "/usr/src/paperless/src/documents/management/commands/document_consumer.py", line 295, in handle_inotify
paperless-ngx | inotify.add_watch(directory, inotify_flags)
paperless-ngx | File "/usr/local/lib/python3.12/site-packages/inotify_simple.py", line 110, in add_watch
paperless-ngx | return _libc_call(_libc.inotify_add_watch, self.fileno(), fsencode(path), mask)
paperless-ngx | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
paperless-ngx | File "/usr/local/lib/python3.12/site-packages/inotify_simple.py", line 39, in _libc_call
paperless-ngx | raise OSError(errno, os.strerror(errno))
paperless-ngx | PermissionError: [Errno 13] Permission denied
paperless-ngx | [2025-10-18 23:39:40,368] [INFO] [paperless.asgi] [init] Paperless-ngx version: v2.18.4
paperless-ngx | __ - ... __ - _
paperless-ngx | LocalTime -> 2025-10-18 23:39:41
paperless-ngx | Configuration ->
paperless-ngx | . broker -> redis://broker:6379//
paperless-ngx | . loader -> celery.loaders.app.AppLoader
paperless-ngx | . scheduler -> celery.beat.PersistentScheduler
paperless-ngx | . db -> /usr/src/paperless/data/celerybeat-schedule.db
paperless-ngx | . logfile -> [stderr]@%INFO
paperless-ngx | . maxinterval -> 5.00 minutes (300s)
paperless-ngx | [2025-10-18 23:39:41,089] [INFO] [celery.beat] beat: Starting...
paperless-ngx | [2025-10-18 23:39:45,110] [INFO] [paperless.management.consumer] Using inotify to watch directory for changes: /usr/src/paperless/consume
paperless-ngx | Traceback (most recent call last):
paperless-ngx | File "/usr/src/paperless/src/manage.py", line 10, in <module>
paperless-ngx | execute_from_command_line(sys.argv)

paperless-ngx | File "/usr/local/lib/python3.12/site-packages/django/core/management/__init__.py", line 442, in execute_from_command_line
paperless-ngx | utility.execute()
paperless-ngx | File "/usr/local/lib/python3.12/site-packages/django/core/management/__init__.py", line 436, in execute
paperless-ngx | self.fetch_command(subcommand).run_from_argv(self.argv)
paperless-ngx | File "/usr/local/lib/python3.12/site-packages/django/core/management/base.py", line 416, in run_from_argv
paperless-ngx | self.execute(*args, **cmd_options)
paperless-ngx | File "/usr/local/lib/python3.12/site-packages/django/core/management/base.py", line 460, in execute
paperless-ngx | output = self.handle(*args, **options)
paperless-ngx | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
paperless-ngx | File "/usr/src/paperless/src/documents/management/commands/document_consumer.py", line 247, in handle
paperless-ngx | self.handle_inotify(directory, recursive, is_testing=options["testing"])
paperless-ngx | File "/usr/src/paperless/src/documents/management/commands/document_consumer.py", line 295, in handle_inotify
paperless-ngx | inotify.add_watch(directory, inotify_flags)
paperless-ngx | File "/usr/local/lib/python3.12/site-packages/inotify_simple.py", line 110, in add_watch
paperless-ngx | return _libc_call(_libc.inotify_add_watch, self.fileno(), fsencode(path), mask)
paperless-ngx | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
paperless-ngx | File "/usr/local/lib/python3.12/site-packages/inotify_simple.py", line 39, in _libc_call
paperless-ngx | raise OSError(errno, os.strerror(errno))
paperless-ngx | PermissionError: [Errno 13] Permission denied
paperless-ngx | [2025-10-18 23:39:49,872] [INFO] [paperless.management.consumer] Using inotify to watch directory for changes: /usr/src/paperless/consume

Display More

Hat jemand eine Idee ?

Tommes · October 19, 2025 at 8:16 AM

Moin!

Wenn du Paperless-ngx zunächst so konfiguriert hast, dass alle persistenten Daten unter /volume2/docker/paperless-ngx liegen, und erst danach die YAML-Datei so verändert hast, dass einige Daten nach /volume1/Brother Scan/ umgeleitet werden, hast du möglicherweise vergessen, auch die bereits vorhandenen persistenten Daten dorthin zu verschieben.

Solltest du dies bereits getan haben, könnte vielleicht ein Berechtigungsproblem in der neu erstellten Ordnerstruktur vorliegen, da in deinem Protokoll u.a. ein paperless-ngx | PermissionError: [Errno 13] Permission denied ausgeworfen wird. Vielleicht könnte es auch ein Problem mit dem Leerzeichen im Ordnernamen /Brother Scan geben. Mach notfalls mal ein /BrotherScan, /Brother-Scan, oder /Brother_Scan draus.

Evtl hilft es, Paperless-ngx nochmal komplett, inkl. der persistenten Ordner zu entfernen um dann die bereits modifizierte YAML noch mal neu auszuführen.

Panteran · October 19, 2025 at 8:26 AM

Moin Tommes,
danke. Ich hatte mich schon gewundert, warum er nach dem löschen des Containers und neu installieren nicht mehr alles neu runterläd. Wo finde ich die persistenten Daten? Bin neu in der Docker Struktur Aber fleisig am einlesen.

Tommes · October 19, 2025 at 8:56 AM

Mit „persistenten Daten“ werden all die Daten bezeichnet, die außerhalb eines Containers ab- bzw. anlegt werden. Dies können Konfigurationsdaten, persönliche Einstellungen und/oder persönliche Daten sein. Den Ablageort für deine persistenten Daten legst du im YAML-File unter volumes fest, also dort, wo du auch deine Eingaben getätigt hast um von /volume1/docker nach /volume2/Brother Scan zu wechseln.

Aber Achtung: Löscht du persistente Daten bzw. Ordner, löscht du mitunter auch alle persönlichen Daten. Daher würde ich mir im Zweifel zunächst ein Backup anlegen. Sollte sich noch nichts nennenswertes innerhalb der persistenten Daten befinden, ist es natürlich egal.

Panteran · October 19, 2025 at 10:03 AM

Quote from Tommes

Mit „persistenten Daten“ werden all die Daten bezeichnet, die außerhalb eines Containers ab- bzw. anlegt werden. Dies können Konfigurationsdaten, persönliche Einstellungen und/oder persönliche Daten sein. Den Ablageort für deine persistenten Daten legst du im YAML-File unter volumes fest, also dort, wo du auch deine Eingaben getätigt hast um von /volume1/docker nach /volume2/Brother Scan zu wechseln.
Aber Achtung: Löscht du persistente Daten bzw. Ordner, löscht du mitunter auch alle persönlichen Daten. Daher würde ich mir im Zweifel zunächst ein Backup anlegen. Sollte sich noch nichts nennenswertes innerhalb der persistenten Daten befinden, ist es natürlich egal.

mhh die Daten auf /volume2/ docker unter data, db und regis habe ich eigentlich immer komplett gelöscht. Trotzdem hat er beim pullen nicht alles neu heruntergeladen.

Panteran · October 20, 2025 at 2:05 PM

So hab die Lösung mit Gemini gefunden, falls jemand ein ähnliches Problem hat.

The PermissionError: [Errno 13] Permission denied error in Paperless-ngx, specifically originating from inotify_simple.py, indicates that the Paperless-ngx container cannot properly access the mounted volumes on your host system.

The inotify library is used by Paperless-ngx to watch the consume directory for changes. The Permission denied error occurs because the user account running inside the Docker container does not have the necessary permissions to read, write, or modify the host directories mapped to the container.

Here are the primary solutions to resolve this issue.

3. Change to polling mode (alternative)

If the above steps don't work, especially if your consumption directory is on a network share (like NFS) that doesn't support inotify, you can switch to polling mode. Polling disables the real-time file system listener (inotify) and has Paperless-ngx check for new files manually on a timer.

Edit your docker-compose.env file. Add the following variable:
ini
Code
```
PAPERLESS_CONSUMER_POLLING=1
```

habe in die Yml Datei das hinzugefügt und neu bereitgestellt

PAPERLESS_CONSUMER_POLLING: 1

Nun läuft es

Tommes · October 20, 2025 at 6:26 PM

Freut mich, das du das Problem lösen konntest. Jedoch bin ich der Meinung, das du das Rechteproblem im /consume Ordner auch sicher hättest anders lösen können. Ich sage das deshalb, weil ich den /consume Ordner ebenfalls außerhalb des Docker-Ordners und sogar auf einem anderen Volume ausgelagert habe und ich keine Meldung über fehlende Rechte erhalte. Aber gut… wenns läuft!

Panteran · October 20, 2025 at 7:41 PM

Quote from Tommes

Freut mich, das du das Problem lösen konntest. Jedoch bin ich der Meinung, das du das Rechteproblem im /consume Ordner auch sicher hättest anders lösen können. Ich sage das deshalb, weil ich den /consume Ordner ebenfalls außerhalb des Docker-Ordners und sogar auf einem anderen Volume ausgelagert habe und ich keine Meldung über fehlende Rechte erhalte. Aber gut… wenns läuft!

Ich habe den Consume Ordner auch außerhalb des Docker Ordners auf einem anderen Volumen und bin als Admin angemeldet, trotzdem meckert er bei dem inotify nach fehlenden Rechten. Ich habe über SSH die Uid und Gid rausgelesen und in der env File geändert => hat nicht geholfen. Auch wenn ich mit der Lösung wie du auch sagst, nicht ganz zufrieden bin, kann ich trotzdem erst mal damit leben

ledies · October 27, 2025 at 9:46 PM

Hallo und Gruß in die Runde.

habe mich eben hier im Forum angemeldet und mein Problem passt zu diesem Beitrag.

Ich nutze (neben drei Synologys) seit neuestem eine DXP4800 Plus mit aktueller BS Version und bin irgendwie auf Paperless-ngx gestoßen.

Also habe dieses auf der Ugreen mit Docker installiert und es läuft aktuell mit Version 2.19.2 auch fast problemlos.

Mittlerweile sind 1500 Dokumente drin und mein einziges Problem besteht darin, dass der /consume Ordner nicht überwacht wird.

Mein Scanner ist so eingerichtet, dass er die Dokumente direkt dort rein speichert, allerdings erfolgt die Verarbeitung erst, wenn ich die Instanz im Docker neu starte. Da die Ugreen nachts runter fährt und morgens wieder rauf, werden die gescannten, oder per SMB abgelegten Dokumente, am nächsten Morgen automatisch erkannt und verarbeitet.

Nach Recherche im Netz habe ich die folgenden Environment nachgetragen:

Code

      PAPERLESS_CONSUMER_POLLING: 60
      PAPERLESS_CONSUMER_POLLING_RETRY_COUNT: 4
      PAPERLESS_CONSUMER_POLLING_DELAY: 10

Allerdings hat es keine Änderung bewirkt.

Meine Volumes sind Standard:

Code

volumes:
      - /volume1/docker/paperless-ngx/data:/usr/src/paperless/data
      - /volume1/docker/paperless-ngx/media:/usr/src/paperless/media
      - /volume1/docker/paperless-ngx/export:/usr/src/paperless/export
      - /volume1/docker/paperless-ngx/consume:/usr/src/paperless/consume

Am Anfang hatte ich im /consume Ordner noch Unterordner, da ich die ganzen gespeicherten Ordner mit den Dokumenten dort hinein kopiert hatte und diese dann sogar nach den Unterordnern getagt wurden. Habe danach allerdings die Unterordner in /consume entfernt, benötige dies jetzt nicht mehr.

in env_file: docker-compose.env sind die Einträge für Polling nicht enthalten. Ist das so richtig?

Ist meine erste Docker Nutzung, habe sonst nur Erfahrung mit OpenHab, Iobroker auf Raspberry Pi und dachte, kannst ja mal die ugreen für sowas nutzen - hat ja richtig Power.

So - hoffe mein Problem ist ausreichend beschrieben und bedanke mich im Voraus für eure Antworten.

Viele Grüße aus der Lausitz,

ledies

Participate now!