🎉 Torrent VPN Stack v1.0.0

First stable release! A production-ready, cross-platform Docker Compose stack for secure torrenting through a VPN with comprehensive features and one-command installation.

✨ Highlights

📦 Package Manager Support

Install with a single command on any platform:

# macOS/Linux (Homebrew)
brew install ddmoney420/torrent-vpn-stack/torrent-vpn-stack

# Windows (Chocolatey)
choco install torrent-vpn-stack

# Arch Linux (AUR)
yay -S torrent-vpn-stack

All packages include system-wide commands:

torrent-vpn-setup - Interactive configuration wizard
torrent-vpn-verify - Verify VPN connection
torrent-vpn-check-leaks - Check for IP/DNS leaks
torrent-vpn-backup - Backup configuration
torrent-vpn-restore - Restore from backup
torrent-vpn-benchmark - Benchmark VPN performance
torrent-vpn-setup-automation - Setup automated backups
torrent-vpn-remove-automation - Remove automated backups

🌐 Full Cross-Platform Support

✅ Windows 10/11 - WSL2 or Git Bash, Task Scheduler automation
✅ Linux - Ubuntu, Debian, Fedora, Arch, systemd/cron automation
✅ macOS - Intel and Apple Silicon M1/M2/M3, launchd automation

🔒 Security & Privacy

VPN Kill Switch - All traffic forced through VPN, no leaks if disconnected
DNS Leak Protection - DNS-over-TLS (DoT) to Cloudflare
IPv6 Disabled - Prevents dual-stack leaks
Firewall Rules - Strict whitelist for VPN + LAN only
Non-root Containers - Least privilege, minimal capabilities

🚀 Performance Features

Port Forwarding Automation - Auto-sync forwarded ports from VPN to qBittorrent
WireGuard & OpenVPN - Modern WireGuard (recommended) or classic OpenVPN
Multi-VPN Provider Support - Mullvad, ProtonVPN, NordVPN, Surfshark, PIA, and 50+ more
Performance Benchmarking - Built-in VPN speed and latency testing

📊 Monitoring & Observability

Grafana Dashboards - Real-time metrics visualization
Prometheus - 30-day metrics retention
qBittorrent Exporter - Torrent-specific metrics (speeds, peers, ratio)
cAdvisor - Container resource monitoring

💾 Automated Backups

Platform-native automation (Task Scheduler, systemd/cron, launchd)
Automatic backup rotation (configurable retention)
Interactive restore with safety backups
Dry-run mode for testing

📋 Full Feature List

See the CHANGELOG for complete details.

🚀 Quick Start

Option 1: Package Manager (Recommended)

# macOS
brew install ddmoney420/torrent-vpn-stack/torrent-vpn-stack
cd $(brew --prefix)/opt/torrent-vpn-stack
torrent-vpn-setup
docker compose up -d

# Windows
choco install torrent-vpn-stack
cd $env:ProgramData\torrent-vpn-stack
torrent-vpn-setup
docker compose up -d

# Arch Linux
yay -S torrent-vpn-stack
cd /usr/share/torrent-vpn-stack
torrent-vpn-setup
docker compose up -d

Option 2: Git Clone

git clone https://github.com/ddmoney420/torrent-vpn-stack.git
cd torrent-vpn-stack
./scripts/setup.sh
docker compose up -d

📚 Documentation

README - Comprehensive user guide
Installation Guides - Platform-specific guides (Windows, Linux, macOS)
Port Forwarding Guide - Setup for Mullvad, ProtonVPN, PIA
Backup Guide - Automated backup setup
Monitoring Guide - Grafana dashboard setup
Architecture - Deep dive into how it works
Provider Comparison - VPN provider analysis
Performance Tuning - Optimization guide

🛠️ Requirements

Docker: Docker Desktop (Windows/macOS) or Docker Engine (Linux)
Docker Compose: v2.0+ (included with Docker Desktop)
VPN Subscription: Mullvad, ProtonVPN, PIA, or 50+ supported providers
RAM: 8 GB minimum (16 GB recommended)
Disk: 20 GB free space (more for downloads)

🎯 Supported VPN Providers

✅ Recommended (with Port Forwarding)

Mullvad - Best overall, port forwarding on all servers
ProtonVPN Plus - Swiss privacy, port forwarding on Plus+ plans
Private Internet Access (PIA) - Budget-friendly, port forwarding supported

⚠️ Works But Limited (no Port Forwarding)

NordVPN, Surfshark, ExpressVPN, and 50+ others

See Provider Comparison for detailed analysis.

📦 Package Repository Status

Homebrew: Ready for publication to tap repository
Chocolatey: Ready for submission to Chocolatey Community Repository
AUR: Ready for submission to Arch User Repository

Publishing guides available in each packaging/*/README.md.

🙏 Acknowledgments

Gluetun by @qdm12 - Excellent VPN client container
LinuxServer.io - qBittorrent Docker image
qBittorrent - Feature-rich torrent client

📝 License

MIT License - See LICENSE for details.

🐛 Reporting Issues

Found a bug? Open an issue

💬 Community

Have questions? Join the Discussions

Made with ❤️ for privacy-conscious torrenters

Releases: ddmoney420/torrent-vpn-stack

v1.0.1 - Homebrew Symlink Fix

What's Changed

Bug Fixes

Updated Scripts

Upgrade Instructions

Uh oh!

v1.0.0 - Cross-Platform Torrent VPN Stack