95 lines
2.5 KiB
Markdown
95 lines
2.5 KiB
Markdown
# 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
|
|
|
|
```bash
|
|
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:
|
|
|
|
```bash
|
|
systemctl --user start nextcloud-borg-backup.service
|
|
journalctl --user -u nextcloud-borg-backup.service -f
|
|
```
|
|
|
|
Timer prüfen:
|
|
|
|
```bash
|
|
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:
|
|
|
|
```bash
|
|
sudo loginctl enable-linger johannes
|
|
```
|
|
|
|
## Bedienung
|
|
|
|
```bash
|
|
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:
|
|
|
|
```bash
|
|
nextcloud-borg-backup restore
|
|
```
|
|
|
|
Bestimmte Datei im neuesten Archiv wiederherstellen:
|
|
|
|
```bash
|
|
nextcloud-borg-backup restore "" "Dokumente/Beispiel.pdf"
|
|
```
|
|
|
|
Bestimmtes Archiv und bestimmten Pfad wiederherstellen:
|
|
|
|
```bash
|
|
nextcloud-borg-backup restore nextcloud-2026-07-10_03-15-00 "Dokumente"
|
|
```
|
|
|
|
Archive bequem lesbar mounten:
|
|
|
|
```bash
|
|
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](Dokumentation.md).
|