eblume/blumeops
1
1
Fork 0
Code Issues Pull requests Projects Releases 83 Packages Wiki Activity Actions

C0: transmission doc — review and correct storage/monitoring details

Browse source 
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>
This commit is contained in:
Erich Blume 2026-04-29 11:00:01 -07:00
commit 817acc5e5e
2 changed files with 10 additions and 9 deletions
Download patch file Download diff file Expand all files Collapse all files

1
docs/changelog.d/+transmission-doc-review.doc.md Normal file
View file

@ -0,0 +1 @@
Reviewed transmission card: corrected storage layout (`/config/` is emptyDir, watch dir disabled) and noted the Prometheus exporter sidecar.

18
docs/reference/services/transmission.md
View file

@ -1,6 +1,7 @@
---
title: Transmission
modified: 2026-02-07
modified: 2026-04-29
last-reviewed: 2026-04-29
tags:
- service
- torrent
@ -22,14 +23,13 @@ BitTorrent daemon, primarily for downloading ZIM archives for [[kiwix]].
## Storage Layout
NFS share on sifaka (`/volume1/torrents`):
| 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 |
| Path | Purpose |
|------|---------|
| `/downloads/` | Active downloads and metadata |
| `/downloads/complete/` | Completed downloads |
| `/config/` | Transmission configuration |
| `/watch/` | Watch directory for .torrent files |
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.
@ -44,7 +44,7 @@ When downloads complete, the zim-watcher CronJob detects new ZIMs and restarts K
## Monitoring
Basic uptime via blackbox probe in [[alloy|Alloy]] k8s (Services Health dashboard).
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|Alloy]] k8s (Services Health dashboard).
Web UI shows: active/seeding/paused counts, speeds, disk usage.