Paperless NGX mit Docker und SambaShare: Ordner korrekt einbinden

Home Assistant 2. Sep. 2025

Einleitung
Die Verwendung von Paperless NGX zur digitalen Dokumentenverwaltung gewinnt zunehmend an Beliebtheit. Die Integration in eine Docker-Umgebung ermöglicht eine flexible und skalierbare Lösung. Ein häufiges Problem ist die korrekte Anbindung von SambaShare-Ordnern, um Dokumente effizient zu verwalten. Dieser Artikel behandelt die korrekte Konfiguration von Paperless NGX in Verbindung mit SambaShare.

Problem
Ein Nutzer hat Schwierigkeiten, Paperless NGX so zu konfigurieren, dass es auf einen SambaShare-Ordner zugreifen kann. Trotz korrekter Docker-Setup und Pfadangaben wird der Ordner nicht erkannt, was die Nutzung der Anwendung einschränkt.

Lösung
Um Paperless NGX erfolgreich mit einem SambaShare-Ordner zu verbinden, ist es wichtig, die richtigen Pfade in der docker-compose.yml-Datei anzugeben. Die Verwendung von "Bind Mounts" ist hierbei entscheidend. Anstelle von relativen Pfaden sollten absolute Pfade verwendet werden, um sicherzustellen, dass Docker die Verzeichnisse korrekt erkennt.

Hier ist die korrekte Konfiguration für die docker-compose.yml:

volumes:
  - data:/home/shares/pi/500gb-sdb1/Paperless/data
  - media:/home/shares/pi/500gb-sdb1/Paperless/media
  - /home/shares/pi/500gb-sdb1/Paperless/paperless-outbox:/usr/src/paperless/export
  - /home/shares/pi/500gb-sdb1/Paperless/paperless-inbox:/usr/src/paperless/consume

In dieser Konfiguration wird der lokale Ordner /home/shares/pi/500gb-sdb1/Paperless/paperless-inbox als consume-Ordner für Paperless NGX verwendet. Dies ermöglicht eine nahtlose Integration und den Zugriff auf die Dokumente.

Schritte zur Umsetzung
1. Öffne die docker-compose.yml-Datei in deinem bevorzugten Texteditor.
2. Ändere die Pfade für die consume und export-Verzeichnisse zu absoluten Pfaden, wie im obigen Beispiel gezeigt.
3. Speichere die Änderungen und starte den Docker-Container neu, um die Konfiguration zu übernehmen.

Hintergrundwissen
Docker verwendet Volumes, um Daten zwischen Containern und dem Host-System zu teilen. Es gibt zwei Hauptarten von Volumes: "Bind Mounts" und "Named Volumes". Bind Mounts ermöglichen es, spezifische Verzeichnisse des Host-Systems in den Container zu mounten, während Named Volumes von Docker verwaltet werden. Bei der Verwendung von SambaShare ist es oft notwendig, Bind Mounts zu verwenden, um sicherzustellen, dass die richtigen Berechtigungen und Pfade verwendet werden.

Zusätzliche Infos

Funktion	Erklärung
`data`	Verzeichnis für die Daten von Paperless NGX.
`media`	Verzeichnis für Mediendateien, die von Paperless NGX verwendet werden.
`export`	Ordner, in den exportierte Dokumente abgelegt werden.
`consume`	Ordner, in den Dokumente zur Verarbeitung abgelegt werden.

Hinweise & Best Practices
- Stelle sicher, dass die SambaShare-Ordner die richtigen Berechtigungen haben, damit der Docker-Container darauf zugreifen kann.
- Verwende immer absolute Pfade in der docker-compose.yml, um Verwirrung zu vermeiden.
- Teste die Konfiguration nach Änderungen, um sicherzustellen, dass Paperless NGX die Ordner korrekt erkennt.
- Halte die Docker-Images und -Container regelmäßig aktualisiert, um von den neuesten Funktionen und Sicherheitsupdates zu profitieren.