Erich Blume 817acc5e5e C0: transmission doc — review and correct storage/monitoring details

Marked last-reviewed: 2026-04-29. Fixed the storage layout table —
`/config/` is an emptyDir (ephemeral), not NFS, and the watch directory
is disabled. Documented the transmission-exporter sidecar that exposes
Prometheus metrics on port 19091.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

2026-04-29 11:00:01 -07:00

1.7 KiB

Raw Blame History

title

modified

last-reviewed

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	`registry.ops.eblu.me/blumeops/transmission`
Storage	NFS PVC from [[sifaka

Storage Layout

Path	Backing	Purpose
`/downloads/incomplete/`	NFS (`sifaka:/volume1/torrents`)	Active downloads
`/downloads/complete/`	NFS (`sifaka:/volume1/torrents`)	Completed downloads
`/config/`	`emptyDir` (ephemeral)	Transmission `settings.json`, regenerated on pod start

The watch directory is disabled (watch-dir-enabled: false); torrents are added via RPC (see Kiwix integration below).

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

A transmission-exporter sidecar (image registry.ops.eblu.me/blumeops/transmission-exporter) scrapes the local RPC and exposes Prometheus metrics on port 19091. Uptime is also covered by a blackbox probe in alloy k8s (Services Health dashboard).

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

kiwix - ZIM archive consumer
sifaka - Download storage

1.7 KiB Raw Blame History