Paperless-ngx in Docker

mscbs · November 21, 2025 at 4:44 PM

Für den reinen Export muss ja der Compose Stack laufen (order zumindest der Webserver, glaube ich). In der Export-Datei sind alle notwendigen Dateien für ein vollständiges Restore drin. Wichtig ist, dann man bei Restoren über den document_importer noch nichts am Paperless eingerichtet hat. Der Importer erwartet eine jungfräuliche Instanz! Das Restoren hat bei mir sogar trotz zwischenzeitlichem Wechsel von Postgres 17 auf Postgres 18 funktioniert.

Bevor ich den kompletten Paperless-Ordner per Restic sichere, wird der Stack sauber heruntergefahren, somit sollten auch die Datenbank in konsistentem Zustand gesichert werden. Wer es ganz genau nehmen will, kann gerne im Script noch ein Datenbank-Dump einbauen und dieses Dump entsprechend wegsichern.

UYELLOW · November 21, 2025 at 5:37 PM

Jetzt kommt der dummie wieder um die Ecke.

Erstmal hängt Cronicle schon beim ersten Befehl

(backup paperless-ngx) on server main failed with error: Script exited with code: 125: /tmp/cronicle-script-temp-jmi92p5cw03.sh: cd: line 3: can't cd to /volume1/docker/paperless-ngx: No such file or directory

Skript sieht aus wie bei dir jedoch sind bei mir die Volumes anders herum mein Docker liegt auf Vol1 und das Backup soll auf Vol2
Wie kommts, dass er das Verzeichnis nicht erreicht?

Zum Thema Document Importer, versteht der Dummie richtig.

Den Export entpacken und zwar in einen jungfräuliches paperless docker export verzeichnis und dann über compose neu bereitstellen?

Sparkling-Art-1626 · November 21, 2025 at 5:42 PM

Du musst die Ordner die du brauchst auch mounten in dein Container.

Quote from UYELLOW

Den Export entpacken und zwar in einen jungfräuliches paperless docker export verzeichnis und dann über compose neu bereitstellen?

Den Export entpacken in einen Ordner der auch im Container gemountet ist und dann den Import ausführen. Siehe https://docs.paperless-ngx.com/administration/#importer

UYELLOW · November 21, 2025 at 6:50 PM

Okay das hab ich glaube geschafft in dem ich das Verzeichnis in der YAML einfach zu den VOLUMES hinzugefügt habe.

Ich glaub ich bin trotzdem einfach zu schwer von Begriff für docker

Code

Error Output

CommandError: That path doesn't exist
tar: export: No such file or directory
tar: error exit delayed from previous errors
/tmp/cronicle-script-temp-jmi95mu2m06.sh: line 6: rclone: not found
docker: 'compose' is not a docker command.
See 'docker --help'
/tmp/cronicle-script-temp-jmi95mu2m06.sh: line 10: /usr/sbin/restic: not found
/tmp/cronicle-script-temp-jmi95mu2m06.sh: line 11: /usr/sbin/restic: not found
/tmp/cronicle-script-temp-jmi95mu2m06.sh: line 12: /usr/sbin/restic: not found
/tmp/cronicle-script-temp-jmi95mu2m06.sh: line 13: /usr/sbin/restic: not found
unknown shorthand flag: 'd' in -d
See 'docker --help'.

Display More

Sparkling-Art-1626 · November 21, 2025 at 7:05 PM

Das Script wird IM Container Context ausgeführt. Das Image wird aber bestimmt kein Restic installiert haben und deshalb funktioniert das nicht. Du müsstest dir ein eigenes Image bauen bzw. das bestehende erweitern um Restic. Dafür müsstest du dich aber um einiges intensiver mit Docker beschäftigen. Das Tool scheint ja nett zu sein, aber nicht, wenn man es in einem Docker Container laufen lässt und mehr will als paar Bash Befehle. SSH und Rsync ist ja schon nicht vorhanden. Ich glaube das Tool ist relativ eingeschränkt mit Docker.

deltapapa · December 4, 2025 at 8:28 PM

Quote from Tommes

Moin!
Einen Wechsel von PostgreSQL nach MariaDB habe ich zwar noch nicht durchgeführt, jedoch habe ich grade eben erst ein entsprechendes Docker-Compose-File veröffentlicht, indem Paperless-ngx auf MariaDB zurückgreift. Hier der Link...
Paperless-ngx inklusive Redis 8, Tika, Gotenberg, MariaDB 12 und phpMyAdmin
Ich habe Tika und Gotenberg einfach mal dazugepackt, weil ich schon öfters danach gefragt wurde. Wer das nicht braucht, kann die Container Services auch wieder löschen.

Moin Moin Tommes,

hast du das mit deinen Einstellungen zum Laufen bekommen?

Ich hatte heute mal ein bisschen Zeit (und weil mein Backup und Export Scripte seit einer Woche ohne Probleme laufen) und habe dann mal versucht, PaperlessNGX mit MariaDB auf der DXP zum Laufen zu bringen.

Klappte leider nicht, zuerst hatte ich ein Fehler in meinen Verzeichnissen (data und mariadb braucht man beide und dann habe ich es nicht geschafft, einen Zugang zur DB zu bekommen (permission denied).

Na ja, dann habe ich mir das alles nochmal in Ruhe angeschaut und die Einstellungen aus meinem Stack von der Syno genommen.

Jetzt laufen die Container seit 4 Stunden fehlerfrei und nachher oder morgen mache ich dann nochmal den Import.

Falls sich jemand für die docker-compose interessiert:

GitHub von deltapapa: paperlessngx-mariadb.yaml

Beste Grüße aus dem Norden,
deltapapa

rhazz · December 5, 2025 at 10:53 AM

Quote from deltapapa

Klappte leider nicht, zuerst hatte ich ein Fehler in meinen Verzeichnissen (data und mariadb braucht man beide und dann habe ich es nicht geschafft, einen Zugang zur DB zu bekommen (permission denied).

Ich hatte vor gut zwei Wochen auch einmal die Konfigurationsdatei von Tommes mit der MariaDB ausprobiert und bei mir ist es daran gescheitert, dass die MariaDB nicht ordentlich hoch gekommen ist und Portainer den Health-Status nicht auslesen konnte, weil der Zugriff auf den User nicht gegeben war. Ich hatte mich dann zwar noch ein, zwei Stunden damit beschäftigt, den Container umzukonfigurieren, aber habe es letztendlich aufgegeben und die Konfiguration mit PostgreSQL genommen, die nahezu sofort ordentlich hochkam.

Aber freut mich trotzdem, dass du es am Ende erfolgreich zum Laufen bekommen hast

Tommes · December 5, 2025 at 12:49 PM

Ich schau mir das an, sobald ich wieder etwas Luft habe

igomyway · December 8, 2025 at 9:49 PM

Paperless „lebt“ in der DXP, aktuell habe ich 1070 Dokumente (die Transformation von der DS zur DXP ist aber noch nicht vollständig abgeschlossen, ich denke mal ca. 500 kommen noch dazu). Auch wenn ich von denen vielleicht ca. 10 % händisch zuweisen musste, es läuft. Das Cronicle-Event, 3-mal wöchentlich, sorgt dafür das auf der DXP alles „neue“ in vorhandene oder automatisch neu erstellte Ordner exportiert werden.

Schöne Woche euch allen

UYELLOW · December 9, 2025 at 11:05 AM

Wär nochmal jemand so gut und könnte mir auf die Sprünge helfen?
Bei mir funktioniert es leider nicht so gut wie bei dir igomyway wie genau sieht dein Conicle Event aus?

deltapapa · December 9, 2025 at 12:17 PM

Moin,

frage ich mich auch gerade, was für Cronicle Events machst du denn? Sortierst du Dokumente an einen anderen Speicherort oder Volumen?

famjak · December 9, 2025 at 12:29 PM

Ich habe auch Cronicle so eingerichtet das ich täglich einen Export mit dem Exporter auf einen separaten Ordner durchführe und diesen dann täglich auch sichere. Es werden aber immer nur die letzten fünf Exporte gespeichert. Ältere werden automatisch gelöscht.

deltapapa · December 9, 2025 at 3:39 PM

Jo, den Exporter lasse ich auch automatisiert laufen, jedoch über Crontab, läuft prima.
Bin dabei eine kleine Artikelserie zu schreiben, wo ich das grob erkläre....

goofy84 · December 9, 2025 at 6:58 PM

Hallo, kann mir jemand nochmals behilflich sein bei der Sortierung für Steuerbelege in paperless? Ich würde gerne eine Ordnerstruktur über Speicherpfade in der Art gestalten, dass die Steuerbelege chronologisch sortiert werden, d.h. ich benötige eine Reihenfolge der Belege und zwar nicht nach Scandatum sondern nach Datum auf dem Beleg. Vorstellung wäre als Ordnerstruktur: Firma/Steuerbeleg Bank/Januar

Im Prinzip möchte mein Steuerberater die Sortierung nach Datum der Belege in Bank und Barbelege und die entsprechenden Kontoauszüge dahinter. Hat jemand mal so etwas realisiert. Ich bin aber auch für andere Vorschläge offen

deltapapa · December 10, 2025 at 9:39 PM

Moin,

diesen Speicherpfad habe ich jetzt eingestellt:

{{ created_year }}/{{ created }}-{{ correspondent }}-{{ document_type }}-{{ title }}

Das sieht dann so aus:

This image is exclusive to our members!
Please log in or register for free to view graphics and attachments.

Das müsstest du dann nur nach deinen Belangen umbauen, wie z.B. hier ausführlich beschrieben:

Paperless-ngx, Teil 4: Speicherpfade konfigurieren

Das Problem von guten Tools: Man gewöhnt sich an sie, man richtet seinen ganzen Workflow entsprechend aus, freut sich des Lebens – und eines Tages? Plopp! Weg…

digital-cleaning.de

Tommes · December 11, 2025 at 6:50 PM

goofy84 Wirf doch mal einen Blick in die Paperless-ngx-Dokumentation, insbesondere in den Abschnitt Placeholders . Darüber lassen sich beliebe Speicherpfade konfigurieren. Wenn du z.B. Firma/Steuerbeleg Bank/Januar erhalten möchtest, dann könnte das ein möglicher Speicherpfad sein...

Code

{{ correspondent }}/{{ document_type }}/{{ created_month_name }}/{{ created }}_{{ title }}

... oder wenn es so sein soll, wie dein Steuerberater empfiehlt, also die Sortierung nach Datum der Belege in Bank und Barbelege und die entsprechenden Kontoauszüge dahinter, könnte das Ganze evtl. so aussehen...

Code

{{ created_year }}/{{ correspondent }}/{{ document_type }}/{{ created }}_{{ title }}

Du könntest auch einen eigenen Pfad erstellen, wo alle Unterlagen für den Steuerberater abglegt werden, das könnte dann evt. so aussehen...

Code

Steuerberater/{{ created_year }}/{{ correspondent }}/{{ document_type }}/{{ created }}_{{ title }}

Wie gesagt, du bist in der Anordnung völlig frei

igomyway · December 16, 2025 at 6:08 AM

Ich habe schon länger „gesucht“ nach einer Möglichkeit ein Werkstattbuch übersetzen zu lassen. Am Ende ging es nur darüber, dass ich das Buch „splitte“ (3-teilig da max. Größe 30 MB) und dann konnte es jeweils unter Einbehaltung der Formatierungen.

Danach „um beim Thema zu bleiben“ die 3 Übersetzungen wieder zusammengefügt und in den Consume abgelegt. Es ist erstaunlich wie schnell (die NVMe’s ?) das Doku verarbeitet wurde von Paperless. Immerhin waren das 65 MB mit 229 Seiten. Stand aktuell heute: 1183 Dokumente bei fast 6 Millionen Zeichen (wie immer das ermittelt wird) und die Seitenanzahl (kann man die nicht irgendwie/wo ermitteln?) kenn’ ich nicht.

ChuchiChästli · December 16, 2025 at 6:35 AM

Betreffend der Seitenzahl kann ich nicht sagen.

Aber was die Tempo bei der Verarbeitung betrifft, kann ich das bestätigen. Ich habe (noch) zwei vollkommen identische Paperless Instanzen in Betrieb. Die eine auf der DS923+ und die andere auf der DXP4800+. Produktiv läuft seit kurzem die DXP-Instanz und beim einlesen von mehrseitigen Dokumenten über NVME gegenüber HDD ist wahrlich ein grosser Unterschied. Obwohl solch grosse Dokumente mit über 200 Seiten habe ich nicht.

Generell meine ich, dass Paperless über NVME flüssiger zu bedienen ist. Auf mein generelles Anwendungsszenario bezogen, fällt mir der Leistungsunterschied zwischen der DS und der DXP bei Paperless am ehesten auf. Auch bei der Bearbeitung von Text- und Tabellendokumenten (Only Office auf der DXP) fühlt sich die DXP etwas zügiger an als bei den Synology Office Anwendungen. Wobei sich dieser Unterschied im Alltag nicht so bemerkbar macht bzw. nicht ins Gewicht fällt. Aktuell nutze ich aus verschiedenen Gründen noch die Synology App - also für Office Dokumente.

Tommes · December 20, 2025 at 2:50 PM

Quote from Tommes

Moin!
Einen Wechsel von PostgreSQL nach MariaDB habe ich zwar noch nicht durchgeführt, jedoch habe ich grade eben erst ein entsprechendes Docker-Compose-File veröffentlicht, indem Paperless-ngx auf MariaDB zurückgreift. Hier der Link...
Paperless-ngx inklusive Redis 8, Tika, Gotenberg, MariaDB 12 und phpMyAdmin
Ich habe Tika und Gotenberg einfach mal dazugepackt, weil ich schon öfters danach gefragt wurde. Wer das nicht braucht, kann die Container Services auch wieder löschen.

FYI: Ich habe die o.a. YAML-Datei aus meinem GitHub Repository genommen und ebenfalls aus der Filebase löschen lassen. Hintergrund ist, das ich bis auf weiteres bei PostgreSQL bleiben werde und ich daher keinerlei Berührungspunkte mit MariaDB haben werden. Auch konnte ich das hier angesprochene Problem...

Quote from deltapapa

Moin Moin Tommes,
hast du das mit deinen Einstellungen zum Laufen bekommen?
Ich hatte heute mal ein bisschen Zeit [...] und habe dann mal versucht, PaperlessNGX mit MariaDB auf der DXP zum Laufen zu bringen.
Klappte leider nicht...

... nicht auf Anhieb lösen. Aber deltapapa hat je bereits eine lauffähige (auf Grundlage meiner eigenen) YAML-Datei für euch bereitgestellt *klick* die ich persönlich aber nicht ausprobiert habe.

Participate now!