Paperless-NGX Anfängerfragen

Hi!

Ob etwas richtig oder falsch ist, erkennt man meist daran, das Paperless-ngx nicht das tut, was man erwartet. Oftmals liegen Konfigurations- oder auch einfache Tippfehler in der YAML-Datei vor.

YAML- bzw. Docker-Compose-Dateien gibt es für Paperless-ngx wie Sand am Meer. Auch unterscheiden sich die Konfigurationen oftmals, je nachdem, wie alt dieses ist und welche Anforderungen der Ersteller an seine Bedürfnisse gestellt hat. Ich habe ebenfalls eine Docker-Compose-Datei im Angebot…

File

Docker-Compose: Paperless-ngx inklusive Redis 8, Tika, Gotenberg und PostgreSQL 18

Docker-Compose: Paperless-ngx:latest inklusive Redis 8, Tika:latest, Gotenberg:latest und PostgreSQL 18

Tommes

November 1, 2025 at 7:44 AM

… falls du noch nach Alternativen suchst. Bei mir heißt der Redis Ordner im übrigen /redisdata.

Was das Thema Jinja-Filter angeht, so habe ich auch ein wenig gebraucht, das alles zu verstehen. Überhaupt hat mich Paperless-ngx in der Vergangenheit ziemlich Nerven gekostet. Mittlerweile hat sich daraus eine Hassliebe entwickelt und will eigentlich nicht mehr ohne.

Wir können das Thema aber gerne weiter aufdröselen. Nur nicht mehr heute.

Quote from Bull

Die Ablage der digitalisierten Dokumente soll aber auf Volume 2 in einem eigens dafür erstellten Verzeichnis erfolgen. Reicht es da, den Pfad in der docker-compose.yml anzupassen?

Theoretisch ja.

Zunächst möchte ich dir zum Thema Paperless-ngx ein wenig Lesestoff an die Hand geben.

Paperless-ngx auf dem Raspberry Pi - erstaunlich gut - Teil 1

Bei Paperless-ngx handelt es sich um eine schlanke Dokumentenverwaltung, die sich rasch im Rahmen eines „papierlosen“ Arbeitsplatzes als ausgesprochen nützlich…

digital-cleaning.de

Als Nächstes muss man Paperless-ngx in zwei Bereiche unterteilen. Einerseits die eigentliche Docker-Konfiguration und -Installation und andererseits die Arbeit mit Paperless-ngx selbst. An manchen Stellen vermischen sich jedoch beide Bereiche, was die Sache nicht einfacher macht. Aber das nur nebenbei.

Was den Speicherort deiner persistenten Daten betrifft, so gibt es kein Richtig oder Falsch. Der Eine legt alle Daten im Dockerverzeichnis ab, der andere verlegt die Speicherorte für den Ordner /media und/oder /consume an einem anderen Ort. Wohin genau du die Daten speichern möchtest, ist dir demnach selbst überlassen. Ich habe es z.B. wieder anders gemacht, indem ich z.B. nur den Ordner /media/documents/originals woanders hinverlege, den eigentlichen Ordner /media aber im Dockerverzeichnis belasse. Am Ende ist nur wichtig, das man alles auf Herz und Nieren testet bevor man damit beginnt, Paperless-ngx zu füttern.

Da wir grade von Speicherorten sprechen. Paperless-ngx speichert Dokumente anhand von Placeholdern , die du frei konfigurieren kannst. Oftmals werden diese Placeholder im Docker-Compose unter PAPERLESS_FILENAME_FORMAT festgelegt, können später aber auch in der WebUI konfiguriert bzw. nachjustiert werden. Das sieht dann z.B. so aus...

PAPERLESS_FILENAME_FORMAT: '{{ correspondent }}/{{ document_type }}/{{ title }}'

Das Problem an diesen Placeholdern ist meines Erachtens jedoch, das sich damit keine durchgängig logische und damit brauchbare Orderstruktur im Dateisystem abbilden lässt. Paperless-ngx arbeitet hier eher nach dem Ludolf'schen Haufenprinzip oder auch auf Grundlage einer chaotischen Lagerhaltung. Paperless-ngx braucht diese Struktur in erster Linie auch überhaupt nicht, da alles über die WebUI verarbeitet, gesucht und gefunden werden kann.

Da ich ein aber strukturierter und ordnungsliebender Mensch bin, ist für mich eine logische Ordnerstruktur absolut essenziell. Hier kommen dann die hier diskutierten Jinja-Filter ins spiel, die auf den Placeholdern aufsetzen. Von daher benötigst du diese Filter nur, wenn dein innerer Monk ebenfalls ständig nach einer angemessenen Ordnerstruktur schreit. Ansonsten kannst du diesen Punkt beruhigt überspringen.

Jetzt habe ich dich aber erst mal genug zugetextet.

Quote from Bull

Ich werde mal lesen, was du verlinkt hast.

Mach das. Ich würde dir aber empfehlen, ggf. noch weitere Tutorials und/oder YouTube Videos anzuschauen, da es jeder ein wenig anders macht. Falls dabei Fragen auftauchen, auf die du keine Antworten findest, dann frag hier oder mach am besten einen eigenen Thread auf.

Quote from Bull

Kann auch sein, dass ich mich mal ein paar Tage nicht melde, da ich noch etliche andere Sachen um die Ohren habe.

Ich lauf mich weg

Quote from Bull

Ich hab nur in der yml Datei den Pfad von Hand auf den Ordner unter volume2 abgeändert, hat aber nichts geholfen.

Hast du Paperless-ngx danach auf redeployed, also neu bereitgestellt bzw. neu gestartet?

Bull & Tommes, auch wenn der Drops gelutscht ist, ihr beide das hier „aushandelt“, vielleicht „hilft“ meine funktionierende YAML (Zugangsdaten anonymisiert):

services:
  redis:
    image: redis:8
    command:
      - /bin/sh
      - -c
      - redis-server --requirepass <REDIS_PASSWORD> # <-- Passwort anonymisiert
    container_name: PaperlessNGX-REDIS
    hostname: paper-redis
    security_opt:
      - no-new-privileges:true
    user: 1002:100
    healthcheck:
      test: ["CMD-SHELL", "redis-cli ping || exit 1"]
    volumes:
      - /volume1/docker/paperlessngx/redis:/data:rw
    environment:
      TZ: Europe/Berlin
    deploy:
      resources:
        limits:
          memory: 256M
        reservations:
          memory: 128M
    restart: on-failure:5

  db:
    image: postgres:18
    container_name: PaperlessNGX-DB
    hostname: paper-db
    user: 1002:100
    security_opt:
      - no-new-privileges:true
    healthcheck:
      test: ["CMD", "pg_isready", "-q", "-d", "paperless", "-U", "paperlessuser"]
      timeout: 45s
      interval: 10s
      retries: 10
    volumes:
      - /volume1/docker/paperlessngx/db:/var/lib/postgresql:rw
    environment:
      POSTGRES_DB: paperless
      POSTGRES_USER: paperlessuser
      POSTGRES_PASSWORD: <DB_PASSWORD> # <-- Passwort anonymisiert
    deploy:
      resources:
        limits:
          memory: 2G
        reservations:
          memory: 1G
    restart: on-failure:5

  gotenberg:
    image: gotenberg/gotenberg:latest
    container_name: PaperlessNGX-GOTENBERG
    hostname: gotenberg
    security_opt:
      - no-new-privileges:true
    user: 1026:100
    command:
      - "gotenberg"
      - "--chromium-disable-javascript=true"
      - "--chromium-allow-list=file:///tmp/.*"
    deploy:
      resources:
        limits:
          memory: 2G
        reservations:
          memory: 1G
    restart: on-failure:5

  tika:
    image: docker.io/apache/tika:latest
    container_name: PaperlessNGX-TIKA
    hostname: tika
    security_opt:
      - no-new-privileges:true
    user: 1026:100
    deploy:
      resources:
        limits:
          memory: 1.5G
        reservations:
          memory: 512M
    restart: on-failure:5

  paperless:
    image: ghcr.io/paperless-ngx/paperless-ngx:latest
    container_name: PaperlessNGX
    hostname: paperless-ngx
    security_opt:
      - no-new-privileges:true
    healthcheck:
      test: ["CMD", "curl", "-fs", "-S", "--max-time", "2", "http://localhost:8000"]
      interval: 30s
      timeout: 10s
      retries: 5
    ports:
      - 8777:8000
    volumes:
      - /volume1/docker/paperlessngx/data:/usr/src/paperless/data:rw
      - /volume1/docker/paperlessngx/trash:/usr/src/paperless/trash:rw
      - /volume2/Paperless-Dokumente/media:/usr/src/paperless/media:rw
      - /volume2/Paperless-Dokumente/export:/usr/src/paperless/export:rw
      - /volume2/Paperless-Dokumente/consume:/usr/src/paperless/consume:rw
    environment:
      PAPERLESS_REDIS: redis://:<REDIS_PASSWORD>@paper-redis:6379 # <-- Passwort anonymisiert
      PAPERLESS_DBENGINE: postgresql
      PAPERLESS_DBHOST: paper-db
      PAPERLESS_DBNAME: paperless
      PAPERLESS_DBUSER: paperlessuser
      PAPERLESS_DBPASS: <DB_PASSWORD> # <-- Passwort anonymisiert
      PAPERLESS_EMPTY_TRASH_DIR: ../trash
      PAPERLESS_FILENAME_FORMAT: '{{ created_year }}/{{ correspondent }}/{{ document_type }}/{{ title }}'
      PAPERLESS_OCR_ROTATE_PAGES_THRESHOLD: 6
      PAPERLESS_TASK_WORKERS: 1
      USERMAP_UID: 1002
      USERMAP_GID: 100
      PAPERLESS_TIME_ZONE: Europe/Berlin
      PAPERLESS_ADMIN_USER: <ADMIN_USER> # <-- anonymisiert
      PAPERLESS_ADMIN_PASSWORD: <ADMIN_PASSWORD> # <-- anonymisiert
      PAPERLESS_URL: http://<SERVER-IP>:8777 # <-- anonymisiert
      PAPERLESS_CSRF_TRUSTED_ORIGINS: http://<SERVER-IP>:8777 # <-- anonymisiert
      PAPERLESS_OCR_LANGUAGE: deu+eng
      PAPERLESS_TIKA_ENABLED: 1
      PAPERLESS_TIKA_GOTENBERG_ENDPOINT: http://gotenberg:3000
      PAPERLESS_TIKA_ENDPOINT: http://tika:9998
    deploy:
      resources:
        limits:
          memory: 3G
        reservations:
          memory: 1.5G
    restart: on-failure:5
    depends_on:
      db:
        condition: service_healthy
      redis:
        condition: service_healthy
      tika:
        condition: service_started
      gotenberg:
        condition: service_started

Bull, wenn bei dir /media weiterhin auf /volume1/docker/paperless/media/ zeigt, obwohl du es in der YAML auf Volume2 geändert hast, wurde der Container vermutlich nicht neu erstellt.

Änderungen am Volume greifen nur nach einem kompletten Recreate:

 docker compose down
docker compose up -d 

Falls es dann noch falsch ist, mit  docker inspect <containername>  prüfen, welcher Host-Pfad wirklich gemountet ist.

Thema Anleitungen: Ich habe die Anleitung „von dem nicht hier genannten“ genutzt, die dortige YAML dann an meine „Bedürfnisse“ angepasst. Fertig und läuft.

OffTopic ON: Ferner hilft mir inzwischen meine zu den Anfängen (DS224+, das blaue Forum) erstellte, inzwischen riesig groß an Speicherplatz, erstellte „Datenbank unter Access“. Den Tipp hat mir mein Kollege aus der Leittechnik (Experte für Kraftwerksautomation, der Kerl auf solch Zeugs und wenn ich mal was frage ), der selbst mit sowas arbeitet, gegeben. Den Grundstock hat der mir herübergereicht und nachdem ich das kapiert hatte wie es erweitert/genutzt/geändert wird, läuft. Die ganzen Befehle kann und will ich mir nicht merken. Ich kann darin Klartext-Suche nutzen.

NEIN, die wird niemanden zur Verfügung gestellt. Falls da Anfragen kommen sollten.

OffTopic OFF und wieder zum Thema

Wenn du noch mal von vorne anfangen willst, würde ich dir jetzt natürlich mein bereits verlinktes Docker-Compose empfehlen

File

Docker-Compose: Paperless-ngx inklusive Redis 8, Tika, Gotenberg und PostgreSQL 18

Docker-Compose: Paperless-ngx:latest inklusive Redis 8, Tika:latest, Gotenberg:latest und PostgreSQL 18

Tommes

November 1, 2025 at 7:44 AM

Bisher wurde es knapp 200-mal heruntergeladen und es gab noch keine Beschwerden. Aber das ist natürlich deine Entscheidung.

Was den /media Ordner angeht, so kannst du diesen gleich bei der Ersteinrichtung an den Ort verschieben, wo du ihn hin haben möchtest. Wichtig ist nur, das der Ordner im Vorfeld bereits existiert. Auch sollte dieser nicht direkt auf einen freigegebenen Ordner zeigen wie z.B. /volume2/media, sondern eher sowas wie /volume2/Dokumente/Digitale_Ablage oder so was in der Art.

Im Docker-Compose sollte die Zeile dann in etwa so aussehen...

- /volume2/Dokumente/Digitale_Ablage:/usr/src/paperless/media:rw

Kannst ja mal berichten, für welches Docker-Compose du dich entschieden hast und ob der Neustart erfoglreich verlief.

Ich habe bei mir nur die Originale an einen separaten Ort liegen, und die werden dort sauber hinein sortiert nach Mandant, Jahr und Monat.....

Sollte die Paperless Instanz mal spinnen, oder ich irgendwann auf einen Nachfolger wechseln,,,,, die Originale sind halt das wichtigste. Daraus kann ja immer eine neue Umgebung gebaut werden, oder man sucht zur Not mal händisch.

The content cannot be displayed because you do not have authorisation to view this content.

The content cannot be displayed because you do not have authorisation to view this content.

FredvomJupiterich mache es zwar genauso wie du, jedoch hilft das Bullim Moment nicht weiter. Von daher...

Zum allgemeinen Verständnis und auf Grundlage des nachfolgenden Beispiels aus meinem Docker-Compose

# Speicherorte persistenter Daten (Pfade vor dem Doppelpunkt nach Bedarf anpassen)
volumes:
  - /volume1/docker/paperless-ngx/data:/usr/src/paperless/data:rw
  - /volume1/docker/paperless-ngx/media:/usr/src/paperless/media:rw
  - /volume1/docker/paperless-ngx/export:/usr/src/paperless/export:rw
  - /volume1/docker/paperless-ngx/consume:/usr/src/paperless/consume:rw

Docker-Container sind „flüchtig“, das heißt, sie sind nur temporär vorhanden. Innerhalb eines Containers gehen daher alle nachträglich hinzugefügten Daten verloren, sobald der Container gestoppt oder gelöscht wird. Da ein laufender Container oftmals selbst Daten erzeugt, verarbeitet und/oder speichert, wird in Docker Compose häufig angegeben, wo diese Daten innerhalb des Containers abgelegt werden. Dies sind die Pfade, die im oben aufgeführten Beispiel HINTER dem Doppelpunkt stehen.

Damit diese Daten nicht verloren gehen, können sie durch Angabe persistenter Pfade außerhalb des Containers an einem beliebigen Ort gespeichert werden. Persistent bedeutet im übrigen soviel wie „anhaltend” oder „beständig”. Das sind genau die Pfade, die im oben aufgeführten Beispiel VOR dem Doppelpunkt stehen.

Sobald der Container wieder gestartet wird, werden die persistenten Daten eingelesen und alles ist chic.

Eigentlich sollte das schon deine Frage beantworten. Es ist also vollkommen egal, ob der Ordner /media z.B. unter /volume1/docker/paperless-ngx/media liegt ODER unter /volume2/dokumente/digitale_ablage/media. Der Ordner muss noch nicht mal /media heißen. Bei mir heißt er beispielsweise /volume2/Dokumente/Aktenarchiv. Am Ende ist nur wichtig, das der Ordner bereits existiert, bevor du den Container das erste Mal startest.

Jetzt schlage ich den Haken zu mir und FredvomJupiter, da wir z.B. nicht den kompletten Ordner /media einem anderen Speicherort zuweisen wollen, sondern nur den Unterordner /media/documents/originals In dem Fall müsstest du dann zwei Volumes bzw. Speicherorte im Docker-Compose benennen, so wie FredvomJupiter in seinem Beitrag gezeigt hat. Aber lass das mal... das sorgt nur unnötig für Verwirrung.

Wie gesagt. Wenn du es so machen möchtest wie FredvomJupiter und ich, dann MUSST du sowohl den /media Ordner als auch den /media/documents/originals spezifizieren. Wo am Ende welcher Ordner liegt, bleibt aber weiterhin dir überlassen.

Wie Paperless am Ende Dokumente im Dateisystem ablegt, wird maßgeblich durch die Placeholder bestimmt. I.d.R. ist es so, das man im Docker-Compose eine Art Standard bestimmt, damit Paperless-ngx alle Dokumente zunächst in diesem Format ablegt.

igomyway hat in seinem Docker-Comose z.B. diese Placeholder verwendet…

PAPERLESS_FILENAME_FORMAT: '{{ created_year }}/{{ correspondent }}/{{ document_type }}/{{ title }}'

In der WebUI kannst du z.B. über den Punkt Speicherpfade Alternativen konfigurieren. Wie gesagt… Placeholder funktionieren schon ziemlich gut weshalb Jinja-Filter nicht immer zwingend erforderlich sind.

Ich würde den eigentlichen /media Ordner eher im Paperless-ngx Verzeichnis von Docker belassen und nur den /originals auslagern. Also z.B. so…

- /volume1/docker/paperlessngx/media:/usr/src/paperless/media:rw:
- /volume2/dokumente/paperless/originale:/usr/src/paperless/media/documents/originals:rw:

Aber wie gesagt… das ist schon eine relativ spezielle Konfiguration. Du musst dir also auch Gedanken darüber machen, wie du diese Konfiguration sichern kannst. Wenn du nämlich vergisst, bei einem Backup von Paperless, den Ordner /originals mit zu sichern, dann bringt dir das nicht viel.

Von daher würde ich an deiner Stelle erstmal klein und einfach anfangen, sonst geht das am Ende alles schief. Und da du jetzt schon ins Straucheln kommst (nicht bös gemeint) befürchte ich, das da am Ende nichts gutes bei raus kommt. Aber jeder so wie er mag. Du wirst wissen, was du willst und tust.

Das, was du da eingestellt hast, macht in meinen Augen jedenfalls wenig Sinn.

Sorry, aber ein internes Backup, von einem Volume auf ein anderes, ist kein wirkliches Backup.

Der Grund, warum ich „nur“ den Ordner „Originals“ ausgelagert habe, liegt hauptsächlich darin begründet, dass ich mir zusammen mit den Jinja-Filtern eine logische Ordnerstruktur geschaffen habe, die mir unabhängig von Paperless-ngx mit den Original-PDF-Dokumenten im Dateisystem vorliegt. Sollte Paperless-ngx irgendwann sterben oder das Projekt eingestellt werden, kann mir das relativ egal sein, da ich dann immer noch alle Originale innerhalb einer logischen Ordnerstruktur habe und kann einfach weiter machen.

Wieviel Speicherplatz du benötigst, liegt ja hauptsächlich an der Masse und an der Größe deiner PDF-Dokumente. Ich habe aktuell ca. 2200 Dokumente mit Paperless verarbeitet und der Originals-Ordner belegt dabei ca. 600 MB.

Im Media Ordner wird neben den Originalen PDF-Dokumenten ein Archiv mit den durch OCR verarbeiteten Originalen hinterlegt.