blumeops/docs/reference/services/borgmatic.md
Erich Blume 54afa0750b Add how-to guide for restoring 1Password backup from borgmatic (#141)
## Summary
- New how-to guide at `docs/how-to/restore-1password-backup.md` with step-by-step procedure for extracting and decrypting a 1Password `.1pux` export from borgmatic backup
- **End-to-end verified**: extracted from today's borg archive, decrypted age key with openssl, decrypted .1pux with age → valid 31MB zip with vault data
- Cross-links added from: disaster-recovery, 1password, borgmatic, backups policy, and how-to index
- Updated disaster-recovery.md from TBD stub to include a procedures table

## Deployment and Testing
- [x] Verified full extraction + decryption flow against live borgmatic archive
- [x] `docs-check-links` passes — all wiki-links valid
- [ ] Review guide for clarity and completeness

Reviewed-on: https://forge.ops.eblu.me/eblume/blumeops/pulls/141
2026-02-10 10:55:00 -08:00

1.3 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

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