Paperless-ngx, Teil 21: Die 1-Klick-Sicherung mit allem „Drum und Dran“

In den Teilen 8 – „Exportfunktion nutzen“ – und 10 – „Das Rundum-sorglos-Backup“ – bin ich bereits ausführlich auf Fragen der automatisierten Sicherung eingegangen. Es gibt nun eine sehr elegante Möglichkeit, alle Automatisierungen zu bündeln und über ein Tool zeitgesteuert durchzuführen. Das Backup-Tool Vorta hatte ich zwar schon kurz erwähnt, aber es enthält eine spezielle Funktion, die ideal zur Nutzung unter Paperless-ngx ist.

Backup-Anleitungen im Netz meist zu umständlich

Ich wundere mich immer wieder, wie kompliziert der Umgang mit Paperless-ngx in vielen Web-Beiträgen oder Youtube-Videos dargestellt wird. Container sichern, Datenbanken, Pfade umleiten, Einstellungen und … und … und. Kann man machen, wird auch funktionieren – ist aber aus meiner Sicht unnötig. Der winzige Export-Befehl von Paperless-ngx, den ich in Teil 8 beschrieben habe, sorgt von Haus aus für eine vollständige Sicherung: Dokumente, Einstellungen, Nutzerkonten, Passwörter – all dies kann per Export-Einzeiler gesichert und per Import-Einzeiler wiederhergestellt werden. Bei meinen Tests hat sich dieses vorgehen auch als deutlich stabiler und flexibler bei Umzügen, System- oder Hardwareänderungen erwiesen. Dieser Export-Einzeiler wird gleich noch eine entscheidende Rolle spielen.

Wie ein Borg-Backup mit Vorta zum Kinderspiel wird

Bei dem Wort Borg fallen mir immer die Cyborgs ein, die im Star Trek Universum in würfelförmigen Raumschiffen kollektiv unterwegs sind. In der Linux-Welt steht Borg für eine besonders sichere Backup-Variante, die platzsparend arbeitet, Backups verschlüsselt und überhaupt mit hundert Parametern auf eigene Bedürfnisse zugeschnitten werden kann. Feine Sache, aber für den Nicht-Terminal-gewohnten-Alltags-Anwender zu kompliziert. Wer tippt schon gerne ein: „borg create --stats --verbose -v /path/zu/repository/::{now:%Y-%m-%d_%H-%M} \`/path/zu/backup/ordner/`“?

Vorta ist eine grafische Oberfläche für Borg-Backupvorgänge. Es lässt sich per Klick aus den Paket-Managern der jeweiligen Linux-Variante beziehen, auch unser Raspberry Pi hat das Tool auf Lager:

Vorta bringt auch den ganzen „Unterbau“ mit, man muss also nicht das Borg-Backup zusätzlich installieren. Nach dem Start stellt es einige Reiter für Speicherorte, Zeitplan, Wiederherstellung usw. zur Verfügung:

Nur der erste Reiter „Repository“ klingt etwas ungewohnt. Man kann das aber einfach als Ablageort oder Speicherpfad übersetzen – schon wird die Sache verständlicher. Man kann ein beliebiges Verzeichnis auswählen: eingebaute SSD, Partition, angeschlossener USB-Speicher, NAS oder ein Laufwerk im Heimnetz. In diesem Beispiel wurde einfach eine USB-Festplatte mit 1 TB an den Raspberry Pi gehängt und der entsprechende Pfad in Vorta ausgewählt:

Im zweiten Reiter „Quellen“ wird der Export-Pfad von Paperless-ngx gewählt. Man könnte einzelne Dateien aussuchen, aber bei unserem Vorgehen kann der ganze Ordner „export“ ausgewählt werden:

Auf den Reiter „Zeitplan“ gehe ich nicht weiter ein, da ich bereits in Teil 8 Vorschläge dazu gemacht habe. Man kann es ja für seine erste Testreihe bei den Vorgaben belassen und dann schauen, was man ändern möchte. Vorta geht da sehr ausgeklügelt vor, so dass neuere Sicherungen vermehrt behalten werden, je mehr Zeit vergeht, desto weniger Sicherungen werden behalten, Duplikate werden vermieden, man kann Vorta Backups auch „ausdünnen“ lassen, es wird komprimiert usw. usw. Man erhält also sehr platzsparende Sicherungen, die aber gleichzeitig sogar eine Versionierung erlauben.

Der Clou: Vorta führt den Export-Befehl selbständig aus!

Jetzt kommt unser Export-Einzeiler ins Spiel. Denn bevor Vorta etwas sichern kann, muss ja eine Sicherungsdatei erstellt werden. Der dafür notwendige Befehl wird im Reiter „Zeitplan“, Abschnitt „Shell-Kommandos“ eingetragen:

Der Export-Befehl lautet:

cd /home/a/paperless-ngx && docker compose exec -T webserver document_exporter ../export -z

Mit dem letzten Parameter „-z“ sorgen wir dafür, dass alle Export-Dateien in ein einzelnes Zip-Archiv gepackt werden.

Möchte man noch ein wenig mehr Platz sparen, so kann man den Befehl erweitern und zunächst ein vorhandenes Export-Archiv im Ordner „export“ löschen und erst danach ein neues Archiv erstellen lassen. Der Löschbefehl wird also vorangestellt:

rm -f /home/a/paperless-ngx/export/* ; cd /home/a/paperless-ngx && docker compose exec -T webserver document_exporter ../export -z

Damit ist die Backup-Konfiguration abgeschlossen. Vorta führt zu den angegebenen Zeit den Export durch und sichert das Export-Archiv.

Zwei Möglichkeiten der Wiederherstellung

Backup ist ja nur die eine Seite – wie sieht es denn mit einem Restore aus? Schließlich wird das gesicherte Archiv benötigt, wenn man nach einem Paperless-ngx-Fehler oder nach einem Geräte-Umzug den Import-Befehl ausführen möchte. Nun, das ist sogar noch einfacher. Vorta führt alle Sicherungen im Reiter „Archive“ auf:

Mit dem Button „Entpacken“ wird das gesicherte Zip-Archiv entpackt und wir können zusammen mit dem Import-Befehl Paperless-ngx wieder zum Laufen bringen. Wie gesagt: Es wird der Stand vollständig wiederhergestellt, so, wie er zum Sicherungszeitpunkt vorhanden war.

Vorta bietet alternativ den Button „Einhängen“ an. Damit werden die Archive wie ein zusätzliches Speichermedium im Dateimanager eingeblendet:

Die zweite Möglichkeit bietet für komplexere Backups, wenn man beispielsweise den ganzen „\home“-Ordner sichert, Vorteile. Man kann sich dann wie gewohnt im Dateimanager bewegen und sich einzelne Dateien oder Ordner herauspicken. Für unser Paperless-ngx-Vorhaben ist die erste Methode ausreichend. Aber man kann ja Vorta gleichzeitig für umfangreichere Sicherungen nutzen.

Einmal eingerichtet muss man sich um nichts mehr kümmern. Vorta funktioniert nach meinen Erfahrungen sehr zuverlässig. Im Unterschied zu anderen Linux-Backup-Programmen muss das Ziel-Medium auch nicht in einem Linux-Format wie ext4 formatiert sein, NTFS usw. funktioniert auch. Insgesamt also eine schlanke und unkomplizierte Sache. Und ganz nebenbei hat man vielleicht ein neues Backup-Programm entdeckt, dass man auch für andere Bereiche einsetzen kann.

/

Bisherige Teile der Paperless-ngx-Serie:

Teil 1: Ausführlicher Überblick
Teil 2: Suche & Tags
Teil 3: consume-Ordner – Einsatz von Scannern
Teil 4: Speicherpfade konfigurieren
Teil 5: Installation auf dem Raspberry Pi
Teil 6: Neue Funktionen in Version 2
Teil 7: Dokumente unterwegs über das eigene Modem abrufen
Teil 8: Exportfunktion nutzen
Teil 9: Update durchführen
Teil 10: Das Rundum-sorglos-Backup
Teil 11: Mail-Abruf mit vielen Extras
Teil 12: Mein Alltag mit Paperless-ngx
Teil 13: Ein Quanten-Code für das Papier-Archiv
Teil 14: Automatisierte Ablage auf Speicherpfaden
Teil 15: Neue Funktion für das Verbinden und Trennen von Dokumenten
Teil 16: Dashboard, smarte Widgets und erweiterte Ansichten
Teil 17: Unterordner des consume-Verzeichnisses nutzen
Teil 18: Paperless-ngx auf Synology/NAS ohne Docker nutzen
Teil 19: Praxisbeispiel – kleine Hausverwaltung
Teil 20: Dokumente per Mail aus dem Heimnetz versenden
Teil 21: Die 1-Klick-Sicherung mit allem Drum und Dran