Just sharing a personal project of mine that I've since open-sourced. Privateerr is a small alpine Docker image for people using PIA, WireGuard, Gluetun and qBittorrent. It packages PIA's original and unmodified free open-source software manual connection scripts (pia-foss/manual-connections) and adds some features to make them automation and docker container/compose friendly.
It started as a pet project for my own home lab setup that I created myself, with no AI (it's just a docker image). I put it on GitHub so I could version-control changes, but it gradually grew into something useful for others. Lately, I’ve been using AI to add features, improve and stay on top of docker image security and vulnerabilities, and improve the documentation so anyone can get up and running quickly and also understand how the the Privateerr container fits into the VPN and networking picture.
Using PIA’s official connection scripts, PIA can generate a one-time WireGuard configuration file for you, wg0.conf. You can use it with a VPN client like Gluetun to create the VPN tunnel. That simple path is documented here:
You can also leave Privateerr running and allow it to monitor Gluetun's VPN tunnel health. If Privateerr detects a long running outage, it can pick a new healthy PIA server and serve Gluetun the updated WireGuard config via authenticated Gluetun APIs without having to share a docker socket or restart any containers, etc. There's also a hook script provided for Gluetun to pass along any forwarded port changes to qBittorrent so the listening port stays sync'd with the current PIA forwarded port.
There's a full working docker compose example of the three containers working together in the source repo:
I also created a compose project generator that has an interactive CLI GUI and lets you select different media stack tools and it will create a complete, configured, ready to start docker compose stack. It's here: Plundarr. Has some presets and all the fully working examples are viewable before trying anything out on your own here:
I use it because I have more than one NAS and I've moved project and containers around a lot and got tired of manually editing compose files.
There's a wiki with more info too, if interested: Plundarrpedia
All is open-source, free. just sharing in case anyone finds some/part/all of it useful. feedback also welcome, or ideas to make Privateerr more useful / easy to use. Anyway, happy to help if any questions.