Erich Blume
f8f11121eb
## Summary - Delete `docs/zk/` directory - all useful content migrated to structured docs - Delete `docs/README.md` - `docs/index.md` is now the documentation root - Add `devpi` reference card and `use-pypi-proxy` how-to guide - Add maintenance notes to `indri` reference (sleep prevention, passwordless sudo) - Add iCloud Photos backup note to `borgmatic` reference - Rewrite `zk-docs` mise task to prime AI context with key docs instead of legacy cards - Update `CLAUDE.md` and `README.md` to remove zk references - Update `exploring-the-docs` with AI context priming section This completes the Diataxis documentation restructuring. All six phases are now done. ## Deployment and Testing - [x] Pre-commit hooks pass (including doc-links validator) - [ ] Build and deploy to docs.ops.eblu.me to verify rendering 🤖 Generated with [Claude Code](https://claude.com/claude-code) Reviewed-on: https://forge.ops.eblu.me/eblume/blumeops/pulls/97
62 lines
1.5 KiB
Markdown
62 lines
1.5 KiB
Markdown
---
|
|
title: borgmatic
|
|
tags:
|
|
- 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 | 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:**
|
|
- `miniflux` on [[postgresql]]
|
|
- `teslamate` on [[postgresql]]
|
|
|
|
**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]]
|
|
|
|
## Related
|
|
|
|
- [[backups | Backups]] - Full backup policy
|
|
- [[sifaka | Sifaka]] - Backup target
|
|
- [[postgresql]] - Database backups
|