pia-qbittorrent
gjergjk/pia-qbittorrent
https://hub.docker.com/r/gjergjk/pia-qbittorrent
sh
false
bridge
https://github.com/GeorgeAL78/pia-qbittorrent-docker/issues
https://github.com/GeorgeAL78/pia-qbittorrent-docker
qBittorrent 5.2.4 combined with Private Internet Access (PIA) VPN, built on Alpine Linux for a minimal footprint.
Features:
• Your real IP stays hidden - if the VPN drops, the container loses its internet
• It fixes itself - spots a VPN that has stopped working, even if it still looks connected
• A dead PIA server is not your problem - it moves to another one nearby, and your forwarded port moves with it
• Keeps up with PIA - the server list refreshes on every container start, so it still works when PIA moves a region
• Faster seeding - PIA port forwarding is set up for you, where your region supports it
• Port forwarding keeps trying - if PIA cannot give you a port at startup, it retries in the background and switches qBittorrent over once it works, with no restart
• Downloads survive updates - progress is saved on shutdown, so nothing re-checks
• Files land with the right owner, so they are readable on Unraid without fixing permissions
• Your PIA login can stay in a protected file instead of the container settings
• Runs on amd64 and arm64
Components:
• qBittorrent 5.2.4 with libtorrent 2.0.15
• Alpine Linux 3.24, Boost 1.92.0
• OpenVPN 2.7.7, WireGuard 1.0.20260223, iptables 1.8.13
Full feature and configuration details: https://github.com/GeorgeAL78/pia-qbittorrent-docker
Custom bridge networks work fine (the VPN tunnel runs inside the container either way). Avoid Host networking: the container would then share the Unraid server's own network stack, so the kill switch's firewall rules, routes and IPv6 settings would be applied to the server — including flushing the iptables rules Docker itself relies on, which breaks networking for other containers.
Extra Parameters must keep --cap-add=NET_ADMIN (the VPN and kill switch need it) and --restart unless-stopped (lets the container restart itself to recover).
Pair with the Windows 11 desktop app: https://github.com/GeorgeAL78/qbittorrent-desktop
Fork of j4ym0/pia-qbittorrent with bug fixes and extra features.
Downloaders:
http://[IP]:[PORT:8888]/
https://raw.githubusercontent.com/GeorgeAL78/unraid-templates/main/pia-qbittorrent.xml
https://raw.githubusercontent.com/GeorgeAL78/pia-qbittorrent-docker/master/readme/icon.png
--cap-add=NET_ADMIN --restart unless-stopped
8888
/mnt/user/downloads/
/mnt/user/appdata/pia-qbittorrent/
netherlands
wireguard
true
99
100
000
8888
true
true
9.9.9.9,149.112.112.112
false
false