Erich Blume
254b93096a
## 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
53 lines
1.4 KiB
Markdown
53 lines
1.4 KiB
Markdown
---
|
|
title: Transmission
|
|
tags:
|
|
- service
|
|
- torrent
|
|
---
|
|
|
|
# Transmission
|
|
|
|
BitTorrent daemon, primarily for downloading ZIM archives for [[kiwix|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|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|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|Alloy]] k8s (Services Health dashboard).
|
|
|
|
Web UI shows: active/seeding/paused counts, speeds, disk usage.
|
|
|
|
## Related
|
|
|
|
- [[kiwix|Kiwix]] - ZIM archive consumer
|
|
- [[storage/sifaka|Sifaka]] - Download storage
|