pivpn

Add new client device

$ sudo pivpn add

$ sudo pivpn list

$ sudo pivpn clients

$ sudo pivpn revoke

$ sudo pivpn uninstall

pivpn [add|list|clients|revoke|uninstall|-d|-u]

pivpn simplifies OpenVPN or WireGuard server management on Linux, particularly Raspberry Pi. It handles certificate generation, client configuration, and connection management through an interactive menu system.
Originally designed for Raspberry Pi, it works on any Debian-based system. It automates the complex setup of VPN servers with security-hardened configurations.

/etc/pivpn/

PiVPN configuration directory with setup variables and protocol settings.

VPN server configuration files managed by PiVPN depending on chosen protocol.

Generated client configuration files for distribution.

add

Create new client configuration

List all client configurations

Show connected clients with statistics

Revoke client certificate

Remove PiVPN installation

Generate debug output for troubleshooting

Check for PiVPN updates

Requires curl for installation script. Initial setup requires internet access. Port forwarding needed on router for external access. WireGuard mode requires kernel 5.6+ or DKMS module.

PiVPN was created to make VPN server setup accessible to home users, particularly those running Raspberry Pi. It evolved to support both OpenVPN and WireGuard protocols, providing security-focused default configurations.

openvpn(8), wg(8), wg-quick(8)