Paperless-ngx Export + E-Mail Report (UGREEN NAS) – Community Script (v1.0)

Ich habe ein kleines Community-Paket gebaut, mit dem ihr auf eurem UGREEN NAS (oder generell per Docker) Paperless-ngx automatisch exportieren könnt – inkl. schöner HTML-E-Mail (Outlook/Handy-tauglich).

✅ Was das Paket macht

  • Startet document_exporter im Paperless-Container
  • Erstellt bei jedem Lauf ein ZIP-Export (z. B. paperless_export_YYYYMMDD_HHMMSS.zip)
  • Backup-Retention: behält nur die letzten X Exporte (einstellbar)
  • HTML-Mail bei Erfolg/Fehler inkl. Infos (Host, Container, Pfade, Log)
  • Optional: Liste der exportierten Dokumente aus dem ZIP (nur Hauptdatei, z. B. nur .pdf, ohne .webp/Duplikate)
  • Legt benötigte Ordner automatisch an (Backup-/Log-Verzeichnis)

⚙️ Konfiguration

  • Alles zentral über die paperlessngx.env (SMTP + Script-Optionen)
  • Wichtig: Wenn ihr euch per SSH anmeldet, bitte zuerst sudo -i ausführen, bevor ihr Befehle/Skripte startet.

📦 Download
➡️ paperless-ngx-community-Pack_Mail_de_v1.zip
(enthält Script + Beispiel-ENV + Anleitung)

📝 Hinweise

  • Das Script ist bewusst „safe“ gehalten und schreibt ein Logfile, damit man Fehler schnell sieht.
  • Feedback / Verbesserungen gern hier drunter – je mehr Tester, desto besser 🙂

Viel Spaß & happy archiving! 😊


The content cannot be displayed because you do not have authorisation to view this content.

  • Version 1.0.0

    • RomanG
    • December 28, 2025 at 9:49 PM
    • 517.52 kB
    • 24 Downloads
January 15, 2026 at 3:54 PM

Hallo Roman,

vielen Dank für das Script.
Verstehe ich richtig:
für das Backup ist ausschließlich die anzupassende Datei: "paperless-export_with_mail.sh" notwendig?

Ich habe auf meinem NAS (dxp4800Plus) zwei Instanzen von paperless laufen.
Daran möchte ich nichts ändern.
Werde ich Glück haben?

Im Voraus meinen besten Dank
LG
Manfred
January 15, 2026 at 11:08 PM
Author

Das kann ich dir leider nicht sagen, weil ich deine Containerkonfiguration nicht kenne. Vergleiche am besten deine Konfiguration im Compose mit diesem Paket.
Wenn das nicht passt und die ENV nicht enthalten ist klapt nichts. :)

volumes:

- /volume2/docker/paperless-ngx/data:/usr/src/paperless/data:rw

- /volume2/docker/paperless-ngx/media:/usr/src/paperless/media:rw

- /volume2/docker/paperless-ngx/export:/usr/src/paperless/export:rw

- /volume2/docker/paperless-ngx/consume:/usr/src/paperless/consume:rw
January 15, 2026 at 11:57 PM

Vielen Dank schon mal.
Darf ich die Docker-Compose und die env hier hochladen?
January 16, 2026 at 8:47 AM
Author

Gerne. Die Mühe brauchst du dir eigentlich nicht zu machen. Du musst deine nur entsprechend anpassen, weil sonst das Script nicht funktioniert :)
Wenn kein Exportverzeichnis existiert, kann das Script nur nicht funktionieren ;)
Steht aber auch alles im Handbuch in dem Paket.
January 16, 2026 at 10:16 AM

Vielen Dank, Roman.
Entschuldige bitte meine dumme Frage:
Also in der paperless-export_with_mail.sh die Pfade anpassen. Die Instanzen von Paperless unberührt lassen?
January 16, 2026 at 11:42 AM
Author

Gerne :)

Du musst an deiner Paperless-Instanz selbst nichts ändern. Wichtig ist nur, dass ein Exportpfad wie im Paket beschrieben existiert und im Container gemountet ist (z. B. /usr/src/paperless/export). Ohne diesen Mount funktioniert das Script nicht.

Anpassen musst du im Normalfall nur die Werte in der .env (Container-Name + Host-Zielpfad, optional TMP/Logfile). Im Script muss außerdem der Pfad zur .env korrekt gesetzt sein, sonst geht gar nichts.

Bei 2 Instanzen: pro Instanz eine eigene .env und jeweils Container-Name/Zielpfad setzen.

Beispiel Container1:
/volume1/docker/paperless1/scripts/paperless-export_with_mail.sh
/volume1/docker/paperless1/export
/volume1/docker/paperless1/paperlessngx.env

Beispiel Container2:
/volume1/docker/paperless2/scripts/paperless-export_with_mail.sh
/volume1/docker/paperless2/export
/volume1/docker/paperless2/paperlessngx.env

Die Scripts werden dann vom Host ausgeführt und greifen je nach .env auf den jeweiligen Container zu.

Steht aber auch alles Schritt für Schritt im elfseitigen Handbuch im Paket.

Siehe auch .env
# ============================================================
# Skript: Paperless Export (document_exporter)
# ============================================================
PAPERLESS_CONTAINER_NAME=Paperless-ngx
# Host-Zielordner für ZIP-Backups (muss existieren/angelegt werden können)
PAPERLESS_HOST_BACKUP_DIR=/volume2/docker/paperless-ngx/export
PAPERLESS_KEEP_FILES=10
# Temp-Ordner im Container
PAPERLESS_CONTAINER_TMP_DIR=/usr/src/paperless/export/_tmp
# Optional: Logfile (Host-Pfad). Wenn leer, nutzt das Script ./scripts/exporter.log
PAPERLESS_EXPORT_LOGFILE=/volume2/docker/paperless-ngx/scripts/exporter.log
# Hinweis: Wenn du unbedingt /tmp nutzen willst, setze z.B. PAPERLESS_CONTAINER_TMP_DIR=/tmp/paperless-export.
# Das Script versucht dann automatisch chmod 777 im Container (via docker exec -u 0).