Paperless-ngx Backup-Script

Version 1.0-600 vom 05.05.2026

• Fälschlicherweise wurde das -T Flag sowohl aus dem [ docker exec ] als auch aus dem [ docker compose exec ] Befehl entfernt, wobei bei letzteren Befehl das -T Flag erhalten bleiben sollte. Fehler wurde korrigiert.

Version 1.0-500 vom 04.05.2026

• Das im docker-Befehl [ docker exec -T ] bzw. [ docker compose exec -T ] enthaltene -T Flag löste unter gewissen Umständen einen Fehler aus, daher wurde das Flag wieder entfernt.

Version 1.0-400 vom 18.04.2026

• Das Skript wurde komplett überarbeitet.
• Alle verbindlichen, benutzerspezifischen Angaben bzw. Variablen müssen daher neu festgelegt werden.
• Alle optionalen, benutzerspezifische Angaben bzw. Variablen wurden vollständig entfernt.
• Docker-Container werden primär über ihren Servicenamen identifiziert und angesprochen, alternativ über den Containernamen oder die Container-ID.
• Welche Docker-Befehle verwendet werden, hängt davon ab, wie ein Docker-Container identifiziert wurde.
  • Bei Angabe des Servicenamens wird [ docker compose exec -T ] verwendet.
  • Bei Angabe des Containernamen bzw. der Container-ID wird [ docker exec -T ] verwendet.
  • Werden sowohl Servicename als auch Containername bzw. Container-ID angegeben, wird der Servicename und damit [ docker compose exec -T ] bevorzugt verwendet.
  • Der Benutzer kann somit den zu verwendenden Docker-Befehl beeinflussen, indem er entweder den Servicenamen oder den Containernamen bzw. die Container-ID angibt.
  • Damit TTY-Fehler in automatisierten, nicht-interaktiven Aufrufen verhindert werden, wurde den Docker-Befehlen das -T Flag hinzugefügt.
• Dem Paperless-Export-Aufruf wurde das Flag -b hinzugefügt, um alle Dateien aus dem Exportverzeichnis zu löschen, die in Paperless-ngx nicht mehr vorhanden sind.
• Dem Paperless-Export-Aufruf wurde das Flag -p hinzugefügt, um die exportierten Dateien in die entsprechenden Unterordner /archive, /originals und /thumbnails einzusortieren.
• Dem Paperless-Export-Aufruf wurde das Flag -z hinzugefügt, um die exportieren Dateien in einer ZIP-Datei nach der Syntax export-YYYY-MM-DD.zip zu archivieren.
• Das Skript durchsucht das Wurzelverzeichnis des Docker-Projekt-Verzeichnisses von Paperless-ngx nach allen Dateien mit den Endungen .yaml und .env und sichert sie.
• Wird eine Datensicherung mit Versionsständen verwendet, werden im Datensicherungsziel Versionsordner im Format "YYYY-MM-DDTHH-MM-SS" angelegt.
• Versionsordner werden nach Ablauf einer vom Benutzer festgelegten Zeit in Tagen automatisch aus dem Datensicherungsziel gelöscht.
• Das Datensicherungsprotokoll wird immer im eigentlichen Wurzelverzeichnis des Datensicherungsziels abgelegt und bei jedem neuen Durchlauf überschrieben.
• Weitere Stilverbesserungen und Codeoptimierungen vorgenommen.

Version 1.0-300 vom 06.04.2026

• Im Skript wurde die Ausgabe von Informationen auf dem Bildschirm und im Protokoll umgestellt.
• Es wird eine Fehlermeldung ausgegeben, wenn die YAML- oder die ENV-Datei nicht gefunden wird.

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 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.