scottgigawatt/privateerr repository overview

⁠⚓ Privateerr

Privateerr is a tiny Docker wrapper that packages the original, unmodified pia-foss/manual-connections⁠ scripts from Private Internet Access (PIA).

⁠📦 Images

docker pull scottgigawatt/privateerr:latest

latest is the newest stable release. To test the newest successful build from main before it becomes a release, opt in to edge:

docker pull scottgigawatt/privateerr:edge

Prerelease versions keep their own tags and never replace latest.

Published tags are multi-architecture manifests for:

Docker should pull the right image for your host automatically.

Images are built from pinned Alpine digests and scanned before publishing. Dependency updates land through Renovate PRs first, so a rebuild of the same source commit does not silently drift to a new base image.

⁠⚡ Fastest Path

Most users should use the GitHub repo because it includes the Compose file, Makefile, example env file, and mounted config directories:

git clone --recurse-submodules https://github.com/scottgigawatt/privateerr.git
cd privateerr
cp example.env .env
PIA_USER="p1234567" PIA_PASS="p0rtRoya1" PIA_PF="false" make run-privateerr

That writes:

⁠🧭 Why Pair It With Gluetun?

Gluetun is a real VPN client. Privateerr is a VPN config generator.

The simple use case is: generate wg0.conf, copy it into the VPN client you already use, and leave.

The powerful use case is: run Privateerr and Gluetun together in Docker Compose. Privateerr writes the WireGuard config plus PIA_WG_SERVER_NAME; the included Gluetun wrapper reads that server name, exports it as SERVER_NAMES, and Gluetun starts with the right PIA WireGuard server for port forwarding.

⁠🔗 Links