Laborratte5/linux-iso-seeder
1
0
Fork 0
mirror of https://github.com/Laborratte5/linux-iso-seeder.git synced 2025-12-30 17:08:17 +01:00
Code Issues Packages 1 Activity Actions
Automated Linux ISO torrent seeder in a single container.
39 commits 3 branches 0 tags 160 KiB
Find a file
Kasper Plougmann 4e39d8ffb2
Update fetch_torrents.py
2025-07-11 16:22:02 +02:00
.github/workflows Update docker-image.yml 2025-07-08 12:50:17 +02:00
.gitignore Initial commit 2025-07-08 12:23:45 +02:00
Dockerfile Update Dockerfile 2025-07-08 12:56:30 +02:00
entrypoint.sh Update entrypoint.sh 2025-07-10 12:31:09 +02:00
fetch_torrents.py Update fetch_torrents.py 2025-07-11 16:22:02 +02:00
LICENSE Initial commit 2025-07-08 12:23:45 +02:00
README.md Update README.md 2025-07-10 12:45:15 +02:00

README.md

linux-iso-seeder

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.

🚀 Features

✅ 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

📦 Volumes

Container Path Purpose
/config Transmission configuration files
/downloads Downloaded ISO files (seeding storage)
/watch Torrent watch folder
/logs Persistent logs for fetch script runs

📝 Usage Example

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

🔍 How it works

  1. On container startup:

    • Updates packages and Transmission to the latest version.
    • Starts fetch_torrents.py in the background.

  2. Daily:

    • Fetches torrent files for configured distros.
    • Downloads them to /watch for Transmission to seed.
    • Logs results and disk usage to /logs/fetch_torrents.log.

  3. Transmission-daemon runs continuously, seeding all loaded torrents.

💡 Contributing

  1. Fork the repository
  2. Create a new branch (feature/your-feature)
  3. Commit your changes with clear messages
  4. 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

🔒 Security considerations

  • Always review container scripts before deployment.
  • This project installs the latest packages on container start for updated clients and security patches.

❤️ Why?

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.