blumeops/docs/reference/services/borgmatic.md
Erich Blume 11ae11e06e Complete Phase 6: documentation cleanup and integration
- Delete docs/zk/ directory (content migrated to structured docs)
- Delete docs/README.md (docs/index.md is now the root)
- Add devpi reference card and use-pypi-proxy how-to guide
- Add maintenance notes to indri reference (sleep prevention, sudo)
- Add iCloud Photos backup note to borgmatic reference
- Rewrite zk-docs task to prime AI context with key docs
- Update CLAUDE.md and README.md to remove zk references
- Update exploring-the-docs with AI context priming section

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-03 20:49:03 -08:00

1.5 KiB

title tags
borgmatic
service
backup

Borgmatic

Daily backup system using Borg backup, running on indri.

Quick Reference

Property Value
Install mise (pipx)
Config ~/.config/borgmatic/config.yaml
Schedule Daily at 2:00 AM
Repository /Volumes/backups/borg/ on [[sifaka

What Gets Backed Up

Directories:

  • ~/code/personal/zk - Zettelkasten
  • /opt/homebrew/var/forgejo - Git forge data
  • ~/.config/borgmatic - Borgmatic config
  • ~/Documents - Personal documents
  • ~/Pictures - Photos (see note below)

iCloud Photos note: macOS Photos.app defaults to "Optimize Mac Storage" which keeps only thumbnails locally. Borgmatic only backs up what's on disk, so iCloud-only photos are NOT backed up via this method.

Databases:

Not backed up (by design):

  • ZIM archives (re-downloadable)
  • Prometheus metrics (ephemeral)
  • Loki logs (ephemeral)

Retention Policy

Period Count
Daily 7
Monthly 12
Yearly 1000

Monitoring

Metrics exposed via textfile collector to prometheus:

  • borgmatic_up - Repository accessibility
  • borgmatic_last_archive_timestamp - Last backup time
  • borgmatic_repo_deduplicated_size_bytes - Disk usage

Dashboard: "Borgmatic Backups" in grafana