How kiwix/operations works
This repository deploys and maintains Kiwix’s Kubernetes infrastructure: users reach hosted library and download services, while cluster workloads also support content distribution and operational services. The graph preserves those major product areas and selected maintenance functions. The README establishes the repository’s infrastructure scope; sampled source confirms the tracker-whitelisting and resource-overview behaviors. Most workload wiring is represented only by manifest filenames in the supplied evidence, so uncertain service-to-service links are omitted.
Main entry points: library ZIM library · load-balancer Mirror load balancer · whitelister.py Torrent whitelister · download-kiwix Download services
Components 23
Content delivery
- ZIM library
zim/library - Download services
zim/download-kiwix - OpenZIM downloads
zim/download-openzim - Mirror load balancer
zim/load-balancer - Master mirror
zim/master-mirror - BitTorrent tracker
bittorrent/tracker.yaml - Torrent whitelister
bittorrent/whitelister.py - Kiwix catalog
zim/library/prod-kiwix-catalog-backend.yaml
Platform services
- Login service
login/login/login.yaml - Drive service
drives/drives.yaml
Hosted applications
Operations
- Web analytics
stats/matomo-app.yaml - Resource overview
cluster-mgmt/overview/build-overview.py - Cluster backup
cluster-backup/cluster-backup.cronjob.yaml
Cluster foundation
- Kubernetes cluster
Other components
- Visitors
- External mirrors
Connections 28
- Visitors → ZIM library: browse
- Visitors → Download services: download
- Visitors → OpenZIM downloads: download
- Visitors → CMS services: access
- Visitors → ZIMfarm: access
- Visitors → Zimit: access
- ZIM library → Kiwix catalog: serves catalog
- Torrent whitelister → Kiwix catalog: fetches OPDS
- Torrent whitelister → BitTorrent tracker: updates whitelist
- External mirrors → Mirror load balancer: mirror content
- Master mirror → Mirror load balancer: syncs content
- Kubernetes cluster → ZIM library: runs workload
- Kubernetes cluster → Download services: runs workload
- Kubernetes cluster → OpenZIM downloads: runs workload
- Kubernetes cluster → Mirror load balancer: runs workload
- Kubernetes cluster → BitTorrent tracker: runs workload
- Kubernetes cluster → Login service: runs workload
- Kubernetes cluster → Drive service: runs workload
- Kubernetes cluster → CMS services: runs workload
- Kubernetes cluster → Cardshop: runs workload
- Kubernetes cluster → Nautilus: runs workload
- Kubernetes cluster → ZIMfarm: runs workload
- Kubernetes cluster → Zimit: runs workload
- Kubernetes cluster → Mirror QA: runs workload
- Kubernetes cluster → Wikis: runs workload
- Kubernetes cluster → Web analytics: runs workload
- Resource overview → Kubernetes cluster: queries resources
- Cluster backup → Kubernetes cluster: backs up