Hier zeige ich euch, wie ihr die Dokumentenverwaltung paperless-ngx mittels Docker und Traefik auf eurem Server installiert.
| Datum | Änderungen |
|---|---|
| 15.05.2022 | Erstellung dieser Anleitung. |
| 01.07.2022 | Kleine Anpassungen |
| 09.08.2022 | Anpassung für Docker Compose v2, Kapitel 5.1 hinzugefügt |
| 31.05.2023 | Anpassung an neue Traefik Anleitung |
0. Grundvoraussetzung
- Docker & Docker Compose v2 (Debian / Ubuntu)
- Traefik v2 + 3 – Reverse-Proxy mit CrowdSec im Stack einrichten
1. Verzeichnis erstellen
Zuerst erstellen wir uns ein passendes Verzeichnis.
mkdir -p /opt/containers/paperless-ngx
Bei diesem Inhalt handelt es sich um exklusiven Content für Community Plus Mitglieder und Supporter.
Bitte logge dich mit deinem Account ein um den Inhalt zu sehen.
4. paperless-ngx starten
Nun könnt ihr paperless-ngx starten. Gebt dazu folgendes ein:
docker compose -f /opt/containers/paperless-ngx/docker-compose.yml up -d
Der erste Start dauert etwas länger, da dann noch alles eingerichtet werden muss.
Wenn ihr dann auf eure Webseite “paperless.euredomain.de” geht, solltet ihr folgendes sehen:
5. Benutzer anlegen
Als nächstes legen wir unseren ersten Benutzer (Super User) an. Dazu gebt ihr folgendes in eurer Konsole ein:
cd /opt/containers/paperless-ngx docker compose run --rm paperless-web createsuperuser
Nun seht ihr folgenden Dialog:
5.1 Fehler beheben
Solltet ihr diese Fehlermeldung bekommen, dann ist dieses Kapitel für euch interessant.
Der Container wird laut docker-compose.env mit dem Benutzer (ID) 1000 gestartet. Wenn ihr noch keinen Benutzer auf eurem Server angelegt habt, dann müsst ihr dies nun tun. Gebt dazu einfach folgendes ein:
adduser <Nutzername> Zum Beispiel adduser christian
Anschließend müsst ihr die Docker Container beenden und alle Ordner im den Verzeichnis löschen:
docker compose -f /opt/containers/paperless-ngx/docker-compose.yml down rm -R /opt/containers/paperless-ngx/consume rm -R /opt/containers/paperless-ngx/data rm -R /opt/containers/paperless-ngx/export rm -R /opt/containers/paperless-ngx/media rm -R /opt/containers/paperless-ngx/pgdata rm -R /opt/containers/paperless-ngx/redisdata
Nun könnt ihr euren Container neu starten. Jetzt sollten die Container neu erstellt werden und der Benutzer 1000 sollte die Rechte daran haben. Ihr könnt die Berechtigungen zusätzlich noch anpassen:
docker compose -f /opt/containers/paperless-ngx/docker-compose.yml up -d chown -R 1000:1000 /opt/containers/paperless-ngx/consume
6. Login
Nun könnt ihr euch mit dem eben erstellten “Super User” anmelden. Dazu geht ihr auf eure Webseite “paperless.euredomain.de” und logt euch ein.
Anschließend solltet ihr folgendes sehen:
7. Quellen
https://github.com/paperless-ngx/paperless-ngx
https://paperless-ngx.readthedocs.io/en/latest/setup.html#install-paperless-from-docker-hub
Mit der Anleitung ist das DMS rasch aufgesetzt, vielen Dank!
Gemäss https://github.com/paperless-ngx/paperless-ngx/blob/main/docker/compose/docker-compose.postgres-tika.yml läuft die Vorgabe von Paperless NGX selbst schon mit Redis 7 und Postgresql 15.
Zudem macht es Sinn, gemäss dieser docker-compose-Datei auch das Einlesen von Office-Dokumenten gemäss https://docs.paperless-ngx.com/configuration/#tika zu ermöglichen, was mit dem Einfügen der folgenden Passagen bestens klappt:
gotenberg:
image: docker.io/gotenberg/gotenberg:7.10
restart: unless-stopped
# The gotenberg chromium route is used to convert .eml files. We do not
# want to allow external content like tracking pixels or even javascript.
command:
– “gotenberg”
– “–chromium-disable-javascript=true”
– “–chromium-allow-list=file:///tmp/.*”
networks:
– default
tika:
image: ghcr.io/paperless-ngx/tika:latest
restart: unless-stopped
networks:
– default
-> Einfügen am Schluss vor:
networks:
proxy:
external: true
Viel Spass beim Ordnung-Machen in euren Dokumenten!
Hallo, danke für die Anleitung.
Leider werden Dokumente die ich Hochlade immer nur in die “Warteschlange” geschoben.
Z.b. beim Hochladen über den Browser steht dann unter der Datei: “Datei hochgeladen, warte…”
Woran kann das liegen?
Großartig – ich stehe vor dem Problem, dass ich nur ein “Bad Gateway” zurückbekomme – allerdings kommt dieser vom CrowdSec … und ich finde nicht wieso …
Es wäre echt super, wenn es zusammen mit Nextcloud laufen würde. Sobald man Paperless installiert hat, dann funktioniert mein Server nicht mehr.
Hallo. Habe Nextcloud bei als Docker laufen. Wollte auch Paperless auf meinem PI installieren, habe es auch installiert. Danach ging meine Nextcloud nicht mehr.
Ich würde gerne einen SMB Shared Ordner einfügen. Welchen Pfad muss ich dafür anpassen? Den consums Pfad oder media?
Hi,
super Anleitung. Was muss ich machen, damit Paperless nur aus dem Netzwerk erreichbar ist, also per IP?
Hallo, was muss ich ändern, wenn ich das System nur lokal und ohne Domain nutzen möchte?
Aus der Anleitung:
Teillösungen:
https://www.himpler.com/blog/lokale-domains-mit-traefik-und-pi-hole/
https://gnulinux.ch/traefik-als-lokaler-reverse-proxy
VG
Thilo
Hallöchen,
in Schritt 5 beim Erstellen des Users stoße ich immer auf folgendes Problem.
ERRORS:
?: PAPERLESS_CONSUMPTION_DIR is not writeable
HINT: Set the permissions of
drwxr-xr-x /usr/src/paperless/consume
to be writeable by the user running the Paperless services
Perfekt funktioniert. Danke
Hallo,
ja das mit dem eigenen Passwort war falsch und die “2x” habe ich auch korrigiert 😉
Viele Grüße
Christian
Seltsam, mit dem paperless Passwort geht. Aber wenn ich das Passwort ändere habe ich den Fehler den auch Ronald hat.
Der Tipp von Martin389 die Zeile POSTGRES_DB:paperless auzukommentieren klappt bei mir nicht.
Vielleicht kann ich Christian das noch einmal ansehen. Oder habt ihr noch eine Idee?
Hallo Ronald,
ich stand ebenfalls vor dem Problem.
Kommentiere die Zeile “POSTGRES_DB: paperless” aus.