P6: Kiwix and Transmission migration planning #35

Merged

eblume merged 3 commits from feature/p6-kiwix-planning into main

2026-01-20 18:42:11 -08:00

eblume commented

2026-01-20 16:17:03 -08:00

Owner

Summary

Detailed planning document for Phase 6 of k8s migration
Transmission as standalone general-purpose torrent service with web UI at torrent.tail8d86e.ts.net
NFS storage on sifaka (/volume1/torrents) shared between both services
Declarative ZIM torrent list in kiwix's ConfigMap, synced to transmission via sidecar
ZIM watcher CronJob for automatic kiwix restart when new archives complete
Supports both GitOps (declarative) and interactive (web UI) torrent management

Architecture Highlights

torrent namespace: Standalone transmission with Tailscale ingress
kiwix namespace: kiwix-serve with torrent-sync sidecar
Shared NFS PV: Single PV referenced by PVCs in both namespaces
No backup needed: Sifaka is RAID 5/6 and already the backup target

Deployment and Testing

Review plan document
Verify NFS export on sifaka is feasible
Approve architecture decisions

🤖 Generated with Claude Code

## Summary - Detailed planning document for Phase 6 of k8s migration - Transmission as standalone general-purpose torrent service with web UI at torrent.tail8d86e.ts.net - NFS storage on sifaka (/volume1/torrents) shared between both services - Declarative ZIM torrent list in kiwix's ConfigMap, synced to transmission via sidecar - ZIM watcher CronJob for automatic kiwix restart when new archives complete - Supports both GitOps (declarative) and interactive (web UI) torrent management ## Architecture Highlights - **torrent namespace**: Standalone transmission with Tailscale ingress - **kiwix namespace**: kiwix-serve with torrent-sync sidecar - **Shared NFS PV**: Single PV referenced by PVCs in both namespaces - **No backup needed**: Sifaka is RAID 5/6 and already the backup target ## Deployment and Testing - [x] Review plan document - [x] Verify NFS export on sifaka is feasible - [x] Approve architecture decisions 🤖 Generated with [Claude Code](https://claude.com/claude-code)

eblume added 1 commit

2026-01-20 16:17:03 -08:00

P6: Detailed plan for kiwix and transmission migration to k8s 7cc9ec04aa

Architecture changes from original stub:
- Transmission as standalone service in torrent namespace with Tailscale ingress
- NFS share /volume1/torrents on sifaka for all torrent downloads
- Kiwix declares desired ZIM torrents in ConfigMap, syncs to transmission via sidecar
- ZIM watcher CronJob detects new .zim files and restarts kiwix hourly
- Both declarative (GitOps) and manual torrent additions supported
- Non-ZIM torrents coexist in same NFS share without affecting kiwix

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

eblume added 1 commit

2026-01-20 17:54:05 -08:00

Use SMB over NFS due to lack of CAP_SYS_ADMIN in podman 7c34451f1e

eblume added 1 commit

2026-01-20 18:10:43 -08:00

P6: Update plan for dedicated Synology user and mark torrents volume done c0a2b100ac

- Mark SMB share creation as DONE (torrents volume already exists)
- Add prerequisite for dedicated k8s-smb Synology user
- Update all 1Password references from synology-smb-torrents to synology-smb-k8s
- Update verification checklist accordingly

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>