nextcloud-borg-backup/README.md

nextcloud-borg-backup

Tägliches Borg-Backup des lokalen Nextcloud-Mounts nach Synology:

• Quelle: /home/johannes/Nextcloud
• Ziel: /net/thor/volume1/NetBackup/Nextcloud/borg-repo
• Historie: 4w, also vier Wochen wiederherstellbare Archive
• Betrieb: systemd User Timer, täglich um 03:15 Uhr mit Zufallsverzögerung
• Restore: über CLI, Suche, Borg-Mount oder gezieltes Extrahieren

Das Projekt ist bewusst klein gehalten: eine Bash-CLI, Konfiguration, systemd-User-Units und Dokumentation. Es eignet sich direkt für ein Gitea-Repository.

Installation

cd /home/johannes/localdev/nextcloud-borg-backup
./scripts/install.sh

Der Installer legt an:

• ~/.local/bin/nextcloud-borg-backup
• ~/.config/nextcloud-borg-backup/config
• ~/.config/nextcloud-borg-backup/passphrase
• ~/.config/systemd/user/nextcloud-borg-backup.service
• ~/.config/systemd/user/nextcloud-borg-backup.timer

Der Installer überschreibt eine vorhandene Konfiguration nicht.

Danach den ersten Lauf manuell starten:

systemctl --user start nextcloud-borg-backup.service
journalctl --user -u nextcloud-borg-backup.service -f

Timer prüfen:

systemctl --user status nextcloud-borg-backup.timer
systemctl --user list-timers nextcloud-borg-backup.timer

Damit der User-Timer auch ohne aktive Anmeldung läuft:

sudo loginctl enable-linger johannes

Bedienung

nextcloud-borg-backup backup
nextcloud-borg-backup list
nextcloud-borg-backup status
nextcloud-borg-backup search Rechnung
nextcloud-borg-backup mount
nextcloud-borg-backup restore
nextcloud-borg-backup check --verify-data

Restore-Beispiele

Neuestes Archiv komplett nach ~/Nextcloud-Restore/<Archivname> wiederherstellen:

nextcloud-borg-backup restore

Bestimmte Datei im neuesten Archiv wiederherstellen:

nextcloud-borg-backup restore "" "Dokumente/Beispiel.pdf"

Bestimmtes Archiv und bestimmten Pfad wiederherstellen:

nextcloud-borg-backup restore nextcloud-2026-07-10_03-15-00 "Dokumente"

Archive bequem lesbar mounten:

nextcloud-borg-backup mount
xdg-open "${XDG_RUNTIME_DIR}/nextcloud-borg-backup-mount"
nextcloud-borg-backup umount

Wichtige Hinweise

Die Borg-Passphrase liegt lokal in ~/.config/nextcloud-borg-backup/passphrase. Ohne diese Datei kann ein verschlüsseltes Borg-Repository im Notfall nicht wiederhergestellt werden. Eine Kopie gehört daher separat und sicher abgelegt.

Weitere Details stehen in Dokumentation.md.