Skip to content

Privateerr

The Privateerr container creates a PIA WireGuard configuration file for Gluetun or another compatible VPN client. Its built-in Python supervisor can replace stale connection settings through Gluetun's authenticated API. Gluetun establishes and runs the VPN tunnel.

Start Privateerr, Gluetun, and qBittorrent

What Privateerr creates

File in config/gluetun/wireguard/ Purpose
wg0.conf WireGuard keys, interface, peer, and endpoint
privateerr.env Matching PIA server identity and port-forwarding support

Keep both files private and together. The supplied three-service stack installs its integration scripts automatically. Automatic recovery is enabled in that stack and in Plundarr when Privateerr and Gluetun are selected. If you write your own Compose file, enable recovery and set its shared key explicitly.

For a different task, create a PIA WireGuard configuration file for another VPN client. Privateerr supports amd64, arm64, and arm/v7; companion services can support fewer platforms.

See configuration handoff for file/mount details or developer documentation for source and tests. Privateerr uses PIA's unmodified connection scripts; test tools stay in the separate Buccaneerr image.