Automated Linux ISO torrent seeder in a single container.
Helps the open-source community by seeding official ISOs for multiple Linux distributions, with no manual intervention after deployment.
✅ Automatically fetches the latest torrent files for:
- Ubuntu (All LTS & ESM)
- Debian (latest stable DVD-1)
- Kali Linux (latest installer, netInstaller & everything ISO)
✅ Daily updates with minimal resource usage
✅ Uses Transmission-daemon (lightweight torrent client)
✅ Logs and metrics for transparency and future monitoring
✅ Automatically cleans up old torrents and their data
✅ Designed as a single-container, deploy-and-forget solution
| Container Path | Purpose |
|---|---|
/config |
Transmission configuration files |
/downloads |
Downloaded ISO files (seeding storage) |
/watch |
Torrent watch folder |
/logs |
Persistent logs for fetch script runs |
docker build -t linux-iso-seeder .
docker run -d \
-v /path/to/config:/config \
-v /path/to/downloads:/downloads \
-v /path/to/watch:/watch \
-v /path/to/logs:/logs \
-p 9091:9091 \
linux-iso-seeder-
On container startup:
- Updates packages and Transmission to the latest version.
- Starts
fetch_torrents.pyin the background.
-
Daily:
- Fetches torrent files for configured distros.
- Downloads them to
/watchfor Transmission to seed. - Logs results and disk usage to
/logs/fetch_torrents.log.
-
Transmission-daemon runs continuously, seeding all loaded torrents.
- Fork the repository
- Create a new branch (
feature/your-feature) - Commit your changes with clear messages
- Push to your fork and submit a pull request
Ideas for contribution:
- Adding more distros or mirrors
- Implementing Prometheus metrics endpoint
- Slack or Matrix notification integration
- Disk cleanup or retention policies
- Always review container scripts before deployment.
- This project installs the latest packages on container start for updated clients and security patches.
Seeding Linux ISOs improves global availability, helps users download faster, and strengthens the open-source ecosystem. This project makes it easy to contribute without daily maintenance.