blumeops/docs/reference/services/transmission.md
Erich Blume 4ccb7b9a26 Fix wiki-links to use filename-based resolution (#90)
## Summary
- Quartz's "shortest" path mode resolves wiki-links by **filename**, not frontmatter title
- Previous PR used title-based links like `[[Grafana Alloy]]` which looked for non-existent `Grafana-Alloy.md`
- Now using filename-based links like `[[alloy|Grafana Alloy]]` which correctly resolve

## Changes
- Rename zk duplicate files with `-log` suffix (e.g., `argocd.md` → `argocd-log.md`)
- Rename `reference/storage/postgresql.md` to `postgresql-storage.md`
- Convert all 175 wiki-links from `[[Title]]` to `[[filename|Title]]` format
- Rename `doc-card-titles` task to `doc-filenames` (checks filename uniqueness, not titles)
- Update pre-commit hook for renamed task

## Deployment and Testing
- [x] Pre-commit hooks pass
- [x] `mise run doc-filenames` shows no duplicate filenames
- [ ] Verify wiki-links work correctly in Quartz build

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

Reviewed-on: https://forge.ops.eblu.me/eblume/blumeops/pulls/90
2026-02-03 15:30:42 -08:00

1.3 KiB

title tags
Transmission
service
torrent

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 [[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:

  1. Reads ZIM torrent list from ConfigMap
  2. Adds missing torrents via RPC
  3. 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
  • sifaka - Download storage