Paperless-ngx auf Synology-NAS installieren (funktioniert auch mit Container Manager) (2024)

In diesem Beitrag habe ich paperless-ngx bereits vorgestellt und beschrieben, warum es ein sehr gutes Dokumenten-Management-System für das papierlose Büro zuhause ist. Hier wird es nun darum gehen, paperless-ngx auf einem Synology-NAS zu installieren (prinzipiell geht es aber auch auf einem Raspberry Pi oder einem anderen NAS).

Du bist Selbstständig oder führst ein kleines Unternehmen? Dann könnte der Videokurs "Paperless-ngx Masterclass" genau das Richtige für dich sein. Hier lernst du nicht nur, wie du paperless-ngx auf deinem Synology-NAS installierst, sondern auch, wie du dir ein perfektes Ökosystem schaffst, um möglichst effizient und strukturiert arbeiten zu können. Klicke hier, wenn du mehr wissen möchtest.

Installation von Container Manager (früher: Docker)

Achtung: Das ursprüngliche Paket "Docker" gibt es nicht mehr, der Nachfolger heißt "Container Manager". Die Anleitung funktioniert dennoch genauso.

Paperless-ngx lässt sich am einfachsten als Docker-Container installieren, weshalb ich diesen Weg beschreibe.

Docker ist ein Tool, womit man verhältnismäßig leicht Software von einem System auf andere Systeme übertragen kann, da man hiermit alle benötigten zusätzlichen Programme (Abhängigkeiten) automatisch installieren lassen kann.

Für alle Synology NAS der Plus-Serie (z.B. DS220+) ist dieses Paket verfügbar und kann direkt im Paketzentrum heruntergeladen werden:

Paketzentrum öffnen:

Nach “Container Manager” suchen (nicht docker, wie hier im Bild) und installieren klicken.
(Bei mir war das Paket schon installiert, daher steht hier “öffnen”):

Einrichtung von SSH-Zugriff

Zwar lässt sich Docker auf einem Synology-NAS auch über das Webinterface bedienen, aber da man viele Einstellungen treffen muss, ist das Vorgehen über Konfigurations-Dateien besser. Um paperless-ngx möglichst einfach auf dem Synology-NAS zu installieren, empfiehlt sich die Einrichtung eines SSH-Zugriffs:

Systemsteuerung im Webinterface öffnen

“Terminal & SNMP” auswählen

Dort den Haken bei “SSH-Dienst aktivieren” setzen.

SSH und nicht Telnet! Beachte, dass du hier SSH und nicht Telnet auswählst. Telnet ist im Gegensatz zu SSH unverschlüsselt und damit unsicher.

Nun kann man über SSH auf die Synology zugreifen:

Windows: Mit “cmd” (Start, “cmd” tippen, Enter)

MacOS, Linux: Mit “Terminal”

Zum Herstellen einer SSH-Verbindung folgenden Befehl im Fenster ausführen:

ssh user@servername

Vorbereitungen für die Docker-Images treffen

Paperless-ngx basiert auf mehreren Docker-Images. Mit den entsprechenden Konfigurations-Dateien können wir unter anderem folgende Einstellungen treffen:

Welche Datenbank soll genutzt werden?
Welche Verzeichnisse sollen genutzt werden (z.B. das Verzeichnis, in dem Scans landen werden)
Welche Texterkennungs-Sprache als Standard gesetzt wird
und vieles mehr.

Die Entwickler von paperless-ngx haben bereits ein paar Beispiel-Konfigurationsdateien veröffentlicht, die dann noch nach eigenen Bedürfnissen angepasst werden können: https://github.com/paperless-ngx/paperless-ngx/tree/main/docker/compose

Ganz ohne Code: Konfigurations-Set als Download

Keine Sorge: Für den Fall, dass du die Konfigurationen nicht selber erstellen und die Ordnerstrukturen anlegen möchtest, habe ich dir ein für Deutschland optimiertes Konfigurations-Set erstellt. Du musst es nur in den Ordner “docker” entpacken, der sich direkt in deinem Benutzerverzeichnis auf dem Synology-NAS befindet. Mein Konfigurations-Set findest zu hier als Download-Produkt.

Konfigurations-Set herunterladen (sofort nach dem Kauf als Download verfügbar)

Heruntergeladenes Konfigurations-Set (als ZIP) mit Drag&Drop in den folgenden Ordner auf dem NAS ziehen:

docker

Rechtsklick auf das ZIP > Entpacken > Hier entpacken
Der Ordner “paperless-ngx” sowie alle seine Unterordner, welche die Konfigurations-Daten enthalten, werden automatisch angelegt.

Achtung Es muss unbedingt auf "hier entpacken" geklickt werden, sonst wird eine falsche Ordnerstruktur angelegt und die Konfiguration wird fehlschlagen.

Inbox-Ordner anlegen (scaninput)

Als nächstes legen wir einen Ordner an, auf den später auch unser Netzwerkscanner Zugriff erhält. Dies geschieht über “Freigegebener Ordner”:

Systemsteuerung öffnen

Freigegebener Ordner öffnen

Erstellen > Freigegebenen Ordner erstellen

Als Name für den freigegebenen Ordner “scaninput” verwenden.

Lese- und Schreibrechte für deinen Benutzer müssen aktiviert werden.

Achtung! Wenn du mein Konfigurations-Set verwendest, muss dieser Ordner wirklich genau so heißen wie im Screenshot. Außerdem müssen für den Benutzer, unter dem später paperless-ngx laufen wird, Lese- und Schreibrechte eingetragen sein.

Docker-Images laden und paperless-ngx ausführen

Der wichtigste Schritt, um paperless-ngx auf deinem Synology-NAS zu installieren, ist das Laden und Ausführen der Docker-Images. Wie das geht, zeige ich dir jetzt:

SSH-Sitzung starten (CMD unter Windows, Terminal unter MacOS und Linux)
(user und synology-hostname durch tatsächliche Namen ersetzen)

ssh user@synology-hostname

Ins Verzeichnis für paperless-ngx navigieren

cd /volume1/docker/paperless-ngx/config

Docker-Container laut Konfiguration herunterladen
(Passwort des Benutzers eingeben, sobald gefragt wird. Es werden keine Zeichen angezeigt, während man das Passwort eintippt!)

sudo docker-compose pull

Administrator für paperless-ngx anlegen
(Hier wird nach dem gewünschten Benutzernamen, E-Mail und Passwort gefragt.)

sudo docker-compose run --rm webserver createsuperuser

Paperless-ngx starten

sudo docker-compose up -d

Fertig! Paperless-ngx ist nun bereit.

Um paperless-ngx zu starten, öffne im Browser folgende Seite:
http://<hostname_deiner_synology>:8000

Gib hier den vormals gewählte Benutzername sowie Passwort ein und du bist startklar!

Fehlermeldung: PAPERLESS_CONSUMPTION_DIR not writable

Manchmal erscheint im letzten Schritt die Fehlermeldung:

PAPERLESS_CONSUMPTION_DIR not writable

Das liegt daran, dass die Berechtigungen für den Benutzer, unter dem paperless-ngx läuft, beim Ordner “scaninput” noch nicht stimmen.

Hierzu habe ich einen ausführlichen Artikel verfasst, mit dem du dieses Problem ganz leicht lösen wirst: Hier gehts zur Lösung.