Erich Blume 254b93096a Phase 2: Add Reference section with 24 technical reference cards (#88 )

## Summary
- Create `docs/reference/` section with 24 technical reference cards
- Services (16): alloy, argocd, borgmatic, 1password, forgejo, grafana, jellyfin, kiwix, loki, miniflux, navidrome, postgresql, prometheus, teslamate, transmission, zot
- Infrastructure (3): hosts, tailscale, routing
- Kubernetes (2): cluster, apps
- Storage (2): sifaka, backups
- Update README to mark Phase 2 as complete
- Add towncrier changelog fragment

## Deployment and Testing
- [ ] Build docs locally to verify wiki-links resolve
- [ ] Deploy via ArgoCD and verify at docs.ops.eblu.me/reference/

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Reviewed-on: https://forge.ops.eblu.me/eblume/blumeops/pulls/88

2026-02-03 14:27:37 -08:00

1.4 KiB

Raw Blame History

title

Transmission

BitTorrent daemon, primarily for downloading ZIM archives for kiwix.

Quick Reference

Property	Value
URL	https://torrent.ops.eblu.me
Tailscale URL	https://torrent.tail8d86e.ts.net
Namespace	`torrent`
Image	`lscr.io/linuxserver/transmission:latest`
Storage	NFS PVC from [[storage/sifaka

Storage Layout

NFS share on sifaka (/volume1/torrents):

Path	Purpose
`/downloads/`	Active downloads and metadata
`/downloads/complete/`	Completed downloads
`/config/`	Transmission configuration
`/watch/`	Watch directory for .torrent files

kiwix reads from /downloads/complete/ to serve ZIM archives.

Integration with Kiwix

The Kiwix deployment includes a torrent-sync sidecar that:

Reads ZIM torrent list from ConfigMap
Adds missing torrents via RPC
Runs on startup and every 30 minutes

When downloads complete, the zim-watcher CronJob detects new ZIMs and restarts Kiwix.

Monitoring

Basic uptime via blackbox probe in alloy k8s (Services Health dashboard).

Web UI shows: active/seeding/paused counts, speeds, disk usage.

kiwix - ZIM archive consumer
storage/sifaka - Download storage

1.4 KiB Raw Blame History