Betrieb¶

Nützliche Befehle¶

Backup-Operationen¶

# Manuelles Backup (alle Repos)
borgmatic create --verbosity 1 --stats

# Nur ein bestimmtes Repo
borgmatic create --repository local-backup --verbosity 1 --stats
borgmatic create --repository hetzner-offsite --verbosity 1 --stats

# Backup in tmux (für lange Läufe)
tmux new -s backup
borgmatic create --repository hetzner-offsite --verbosity 1 --list --stats
# Ctrl+B, D zum Verlassen
# tmux attach -t backup zum Zurückkehren

Informationen anzeigen¶

# Alle Archive auflisten
borgmatic list

# Repository-Info (Größe, etc.)
borgmatic info

# Spezifisches Repository
borgmatic info --repository local-backup
borgmatic info --repository hetzner-offsite

Logs und Status¶

# Letztes Backup-Log
journalctl -u borgmatic.service -e

# Timer-Status
systemctl status borgmatic.timer
systemctl list-timers borgmatic.timer

# Nächsten Lauf prüfen
systemd-analyze calendar "*-*-* 02:00:00"

Konfiguration¶

# Konfiguration validieren
borgmatic config validate

# Konfiguration anzeigen (mit aufgelösten Includes)
borgmatic config show

RAID und Dateisystem¶

# RAID-Status
cat /proc/mdstat
sudo mdadm --detail /dev/md0

# btrfs Info
btrfs filesystem show /mnt/backup-nas
btrfs filesystem df /mnt/backup-nas

# btrfs Scrub manuell starten
sudo btrfs scrub start /mnt/backup-nas
sudo btrfs scrub status /mnt/backup-nas

Wiederherstellung¶

Archive durchsuchen¶

# Alle Archive auflisten
borgmatic list

# Inhalt eines Archives anzeigen
borgmatic list --archive nuc-2026-01-04_16-17

# Nach Datei suchen
borgmatic list --archive latest --path home/user/dokument.txt

Einzelne Dateien wiederherstellen¶

# In aktuelles Verzeichnis extrahieren
borgmatic extract --archive latest --path home/user/dokument.txt

# In bestimmtes Verzeichnis extrahieren
borgmatic extract --archive latest \
    --path home/user/dokument.txt \
    --destination /tmp/restore

Komplettes Verzeichnis wiederherstellen¶

borgmatic extract --archive latest \
    --path home/user/Dokumente \
    --destination /tmp/restore

Komplettes System wiederherstellen¶

# 1. Neues System aufsetzen mit gleichem OS
# 2. Borg und Borgmatic installieren
# 3. SSH-Key und Passphrase bereitstellen
# 4. Komplettes Archiv extrahieren

borgmatic extract --archive latest --destination /mnt/restore

Archive mounten (für Exploration)¶

# Archiv mounten
mkdir /mnt/borg-mount
borgmatic mount --archive latest --mount-point /mnt/borg-mount

# Dateien durchsuchen
ls /mnt/borg-mount

# Nach Fertigstellung unmounten
borgmatic umount --mount-point /mnt/borg-mount

Wartung¶

Wöchentlich¶

systemctl status borgmatic.timer — Timer läuft?
journalctl -u borgmatic.service --since "1 week ago" — Fehler im Log?

Monatlich¶

borgmatic info — Repository-Größe prüfen
cat /proc/mdstat — RAID-Status prüfen
btrfs Scrub läuft automatisch (Log prüfen: /var/log/btrfs-scrub.log)

Bei Problemen¶

# Manuellen Backup-Test
borgmatic create --repository local-backup --verbosity 2

# Repository-Check
borgmatic check --repository local-backup

# Bei Korruption (Vorsicht!)
borgmatic check --repair --repository local-backup