mreithub/peervpn repository overview

⁠(Inofficial) dockerized PeerVPN instance

This docker image contains a PeerVPN⁠ instance wrapped into a small python script to simplify configuration (which can now be done using environment variables or a custom peervpn.conf file).

This image is automatically built. Its source can be found on GitHub⁠.

⁠Environment variables

• VPN_NAME: Name of your VPN. Must be the same on all peers
• VPN_KEY: pre-shared key (the shared password of the VPN)
• VPN_IP: This peer's IP within the VPN (e.g. 10.8.0.13/24)
• VPN_PEERS: List of initial peers (<host1> <port1> [<hostN> <portN>...], e.g. 8.8.8.8 7000)

To run the VPN as docker container, use something like this:

docker run -d --privileged --net host --env VPN_NAME=somevpn --env VPN_IP=10.8.0.10/24 mreithub/peervpn

⁠Custom config file

Alternatively (for more fine-grained control), you can use your own peervpn.conf file and bind-mount it as a volume (in which case above environment variables will be ignored).

docker run -d --privileged --net host -v '/path/to/vpn.conf:/peervpn.conf' mreithub/peervpn

⁠Notes

• To run the VPN from inside the docker container, use the --privileged and --net host docker options