Paperless-ngx Backup-Script

Export und anschließende Sicherung von Datenbankinhalten, Metadaten, Benutzerprofilen, Einstellungen usw. von Paperless-ngx

Mithilfe des hier vorgestellten Skripts sollen der Export und die anschließende lokale Sicherung von Datenbankinhalten, Metadaten, Benutzerprofilen, Einstellungen usw. von Paperless-ngx erleichtert werden. Hierzu werden Funktionen genutzt, die sowohl Paperless-ngx als auch PostgreSQL selbst anbieten. Mit rsync werden darüber hinaus weitere wichtige Konfigurationsdateien wie die YAML- und die ENV-Datei gesichert. Das eigentliche Dockerverzeichnis von Paperless-ngx (z.B. /volume1/docker/Pakerless-ngx) wird dabei jedoch nicht gesichert, da mit den oben genannten Export-Funktionen und rsync-Aufgaben bereits alle relevanten Daten für eine spätere Wiederherstellung erfasst wurden.

Für eure Fragen, Probleme, Lösungs- und/oder Verbesserungsvorschläge nutzt bitte den nachfolgend verlinkten Thread.

  • Version 1.0-200

    • Tommes
    • January 2, 2026 at 8:53 PM
    • 34 Downloads

    Version 1.0-200 vom 02.01.2026

    • Im Abschnitt "Verbindliche, benutzerspezifische Angaben" des Skriptes, wurde die Variable version_history hinzugefügt.
    • Im Abschnitt "Optionale, benutzerspezifische Angaben" des Skriptes, wurde die Variable tarfolder hinzugefügt.
    • Nachdem alle Sicherungen durchgeführt wurden, wird bei Bedarf eine gepackte .tgz-Archivdatei, benannt nach dem aktuellen Datum und der Uhrzeit im Unterverzeichnis tarfolder des Datensicherungsziels abgelegt.
    • Ältere Archivdateien bzw. Versionsstände werden aus dem Unterverzeichnis gelöscht, sobald eine angegebene Zeit in Tagen version_history überschritten wurde.

  • Version 1.0-100

    • Tommes
    • December 21, 2025 at 9:48 AM
    • 25 Downloads

    Version 1.0-100 vom 21.12.2025

    • Die Variablen username, groupname, paperless_service und postgresql_service wurden entfernt.
    • Die Variablen für optionale, benutzerspezifische Angaben wurden angepasst.
    • Um im Nachgang die Verzeichnis- und Dateirechte im Datensicherungsziel anzupassen, wurde die Ermittlung von Benutzer und Gruppe automatisiert.
    • Um sicherzustellen, dass die Befehle document_exporter und pg_dump innerhalb des Paperless-ngx-Verzeichnis ausgeführt werden, wurde ein automatischer Verzeichniswechsel implementiert.
    • Die Syntax der Befehle document_exporter und pg_dump wurden angepasst.

  • Version 1.0-000

    • Tommes
    • December 18, 2025 at 7:06 PM
    • 20 Downloads
December 20, 2025 at 7:56 AM
Author

Hinweis: Ich habe mich gerade mit Mike0185 ausgetauscht und wir sind beide der gleichen Meinung: Der Bereich „Kommentare” ist eher dafür gedacht, Feedback zu sammeln, und nicht, um Support zu leisten. Daher kopiere ich die bisherige Konversation in den Thread Paperless-ngx Backup-Script ,um zukünftig dort eure Fragen, Probleme, Lösungs- und/oder Verbesserungsvorschläge zu thematisieren.
December 19, 2025 at 10:26 AM

Funktioniert leider nicht. Als Ausgabe kommt lediglich:

---------------------------------------------------------------------------------------------------------
Paperless-ngx Datensicherungsprotokoll vom 19.12.2025 um 10:25:14 Uhr
- Datensicherungsziel: /volume1/docker/backups/paperlessngxbackup
---------------------------------------------------------------------------------------------------------

Die integrierte Exportfunktion von Paperless-ngx wird ausgeführt....
read /volume1/docker: is a directory
root@DXP4800PLUS:/volume1/docker#
:/
December 19, 2025 at 10:55 AM
Author

Welchen Pfad hast du denn für paperless_dir eingesetzt?

Hast du in deinem Paperless Verzeichnis ein Unterverzeichnis mit dem Namen export?
December 19, 2025 at 7:03 PM

Unterverzeichnis export ist vorhanden. Der Pfad für paperless_dir lautet: paperless_dir="/volume1/docker/paperlessngx