Paperless NGX - Backup Skript von Deployn

Moin zusammen,

ich bin beim Vertiefen meines Wissens über dieses Paperless NGX Backup-Skript gestolpert.

Hier geht es zur Webseite des Entwickers

Hat Da schon jemand Erfahrungswerte sammeln können? Wäre das auch für die Ugreen umsetzbar?

Beste Grüße,

Stefan

Moin zusammen,

ich habe mir das jetzt soweit hingefummelt und kann sehr gut damit leben. Für die Nachwelt habe ich das mal kurz zusammengefasst.

Ich für meinen Teil bin durch mit dem Thema Backup

🏛️ Das Konzept (3-Stufen-Strategie)

1. Konsistenz (Local Backup): Ein Skript zieht jede Nacht einen sauberen SQL-Dump (pg_dump) und synchronisiert die PDFs (document_exporter) in einen lokalen Backup-Ordner auf dem NAS.
2. Automation (Cron): Der Linux-Cronjob führt das Skript automatisch aus (Sonntags 03:00 Uhr).
3. Sicherheit (Duplicati): Ein Duplicati-Container verschlüsselt diesen sauberen Ordner und schiebt ihn auf eine externe USB-Platte (oder Cloud).

🛠️ Schritt 1: Das Backup-Skript (Der "Dumper")

Anstatt einfach den Docker-Ordner zu kopieren (Gefahr von korrupten Datenbanken!), nutzen wir die internen Tools von Paperless.

Pfad: /volume1/docker/paperless-ngx/scripts/paperless-backup.sh

Das macht das Skript:

1. Erstellt einen SQL-Dump der laufenden Datenbank.
2. Exportiert neue Dokumente inkrementell (spart Speicher).
3. Sichert die docker-compose.yaml.
4. Rotation: Löscht automatisch alles, was älter als 3 Versionen ist (Keep last 3).

Bash

#!/bin/bash

# --- KONFIGURATION ---
PROJECT_DIR="/volume1/docker/paperless-ngx"
BACKUP_DIR="$PROJECT_DIR/backup"
LOG_FILE="$PROJECT_DIR/backup_full.log"
RETENTION_COUNT=3
DATE=$(date +"%Y%m%d_%H%M%S")

# --- LOGGING ---
log() { echo "[$(date +'%Y-%m-%d %H:%M:%S')] $1" | tee -a "$LOG_FILE"; }

log "=== BACKUP START ==="

# 1. Datenbank Dump (Container muss laufen!)
log "Schritt 1: Exportiere Datenbank..."
docker compose -f "$PROJECT_DIR/docker-compose.yaml" exec -T db pg_dump -U paperless -d paperless -f /backup/dump_$DATE.sql

# 2. Dokumente Export (Inkrementell)
log "Schritt 2: Synchronisiere Dokumente..."
docker compose -f "$PROJECT_DIR/docker-compose.yaml" exec -T webserver document_exporter /usr/src/paperless/export

# 3. Config sichern
cp "$PROJECT_DIR/docker-compose.yaml" "$BACKUP_DIR/docker-compose_$DATE.yaml"

# 4. Aufräumen (Behalte letzte 3)
cd "$BACKUP_DIR"
ls -tp dump_*.sql | grep -v '/$' | tail -n +$(($RETENTION_COUNT + 1)) | xargs -I {} rm -- "{}" 2>/dev/null
ls -tp docker-compose_*.yaml | grep -v '/$' | tail -n +$(($RETENTION_COUNT + 1)) | xargs -I {} rm -- "{}" 2>/dev/null

log "=== BACKUP ENDE ==="

Hinweis: Damit das klappt, muss in der docker-compose.yaml der Pfad ./backup in die Container gemountet sein!

⏰ Schritt 2: Die Automatisierung (Cronjob)

Da UGOS Pro aktuell keinen detaillierten GUI-Planer für Root-Skripte hat, wird der Job via SSH eingetragen.

Befehl: sudo crontab -e Eintrag (jeden Sonntag 03:00 Uhr):

Code-Snippet

0 3 * * 0 /bin/bash /volume1/docker/paperless-ngx/scripts/paperless-backup.sh

🔒 Schritt 3: Die externe Sicherung (Duplicati)

Das Skript legt die Daten nur "sauber" auf das NAS. Für den Schutz vor Festplattenausfall nutzt ich Duplicati als Docker-Container.

Docker-Volume Mapping (Flexibel):

• Quell-Zugriff: - /volume1:/source (Damit kann ich alles auf dem NAS auswählen)
• Ziel-Zugriff: - /mnt/@usb/sdb1:/target_usb (Zugriff auf den USB-Stick)

Duplicati Job:

• Quelle: /source/docker/paperless-ngx/backup
• Ziel: /target_usb/Paperless_Encrypted
• Zeitplan: Sonntags 04:00 Uhr (1 Std. nach dem Skript).
• Methode: Smart Retention (behält Versionen über Monate hinweg, sehr platzsparend dank Deduplizierung).

♻️ Schritt 4: Der Restore (Notfallplan)

Sollte das NAS abrauchen, gehe ich so vor:

1. Paperless Stack neu aufsetzen (leer).
2. Daten aus Duplicati/USB zurück in den Ordner backup kopieren.

3. Import via Terminal:

   Bash

   
   

   Code

   # Datenbank wiederherstellen
   docker compose exec -T db psql -U paperless -d paperless -f /backup/dump_DATUM.sql
   
   # Dokumente neu einlesen & verknüpfen
   docker compose exec -T webserver document_importer /usr/src/paperless/export

Damit habe ich eine 100% saubere Wiederherstellung inkl. aller Tags, User und Pfade.

Vielleicht hilft das dem ein oder anderen Ugreen-Besitzer hier!

Beste Grüße, Stefan

Quote from Tommes

Falls es jemanden interessiert!

Ich habe mein eigenes Paperless-ngx Backup-Script geschrieben und euch auf GitHub zur Verfügung gestellt.

Hallo Tommes,

vielen Dank für deine Hinweise und entschuldige bitte, dass ich mich erst heute dazu melde. Ich habe mir einen Teil meiner Leber ausbauen lassen, weil da was drin war, was da nicht hingehörte. Nun denn, das Leben geht weiter ... . Insbesondere der Hinweis auf den export-Ordner war sehr gut. - manchmal sieht man den Wald vor lauter Bäumen nicht :-D.

Ich habe gelesen, dass Du ein eigenes Skript gebaut hast. Ich werde mir das die nächsten Tage mal anschauen und ggf. auch wechseln, weil ich denke, dass Du bestimmt noch an Dinge gedacht hast, die ich nicht auf dem Schirm hatte.

Beste Grüße,

Stefan