protonvpn.md

ProtonVPN

TLDR

# OpenVPN
docker run -it --rm --cap-add=NET_ADMIN --device /dev/net/tun \
-e VPN_SERVICE_PROVIDER=protonvpn \
-e OPENVPN_USER=abc -e OPENVPN_PASSWORD=abc \
-e SERVER_COUNTRIES=Netherlands qmcgaw/gluetun

# Wireguard
docker run -it --rm --cap-add=NET_ADMIN --device /dev/net/tun \
-e VPN_SERVICE_PROVIDER=protonvpn \
-e VPN_TYPE=wireguard \
-e WIREGUARD_PRIVATE_KEY=wOEI9rqqbDwnN8/Bpp22sVz48T71vJ4fYmFWujulwUU= \
-e SERVER_COUNTRIES=Netherlands qmcgaw/gluetun

version: "3"
services:
  gluetun:
    image: qmcgaw/gluetun
    cap_add:
      - NET_ADMIN
    devices:
      - /dev/net/tun:/dev/net/tun
    environment:
      - VPN_SERVICE_PROVIDER=protonvpn
      - VPN_TYPE=wireguard
      - WIREGUARD_PRIVATE_KEY=wOEI9rqqbDwnN8/Bpp22sVz48T71vJ4fYmFWujulwUU=
      - SERVER_COUNTRIES=Netherlands

💁 To use with Wireguard, download a configuration file from account.proton.me/u/0/vpn/WireGuard and head to the custom provider Wireguard section. Thanks to @pvanryn for pointing this out. Note however you cannot filter servers as easily as with OpenVPN since each server uses its own private key and/or peer address.

Required environment variables

• VPN_SERVICE_PROVIDER=protonvpn

OpenVPN only

• OPENVPN_USER is your OPENVPN specific username. Find it at account.proton.me/u/0/vpn/OpenVpnIKEv2.
• OPENVPN_PASSWORD

Wireguard only

• VPN_TYPE=wireguard
• WIREGUARD_PRIVATE_KEY is your 32 bytes key in base64 format. The private key can only be obtained by generating a Wireguard configuration file. Generate a Wireguard configuration file, copy the displayed PrivateKey value and optionally download the configuration file. Note this value is the same for all ProtonVPN servers. 💁 Guide on how to generate a configuration file

Optional environment variables

• SERVER_COUNTRIES: Comma separated list of countries
• SERVER_REGIONS: Comma separated list of regions
• SERVER_CITIES: Comma separated list of cities
• SERVER_HOSTNAMES: Comma separated list of server hostnames
• FREE_ONLY: Filter only free tier servers by setting it to on. It defaults to off.
• STREAM_ONLY: Filter only free tier servers by setting it to on. It defaults to off.
• SECURE_CORE_ONLY: Filter only secure core servers by setting it to on. It defaults to off.
• TOR_ONLY: Filter only TOR servers by setting it to on. It defaults to off.
• PORT_FORWARD_ONLY: Filter only port-forwarding enabled (aka p2p) servers by setting it to on. It defaults to off.
• OPENVPN_ENDPOINT_PORT: Custom OpenVPN server endpoint port to use
  • For TCP: 443, 5995 or 8443
  • For UDP: 80, 443, 1194, 4569, 5060
  • Defaults are 1194 for UDP and 443 for TCP
• VPN_PORT_FORWARDING: defaults to off and can be set to onto enable port forwarding on the VPN server.

VPN server port forwarding

Requirements:

• Add +pmp to your OpenVPN username (thanks to @mortimr)
• VPN_PORT_FORWARDING=on
• If you use Wireguard using the custom provider, set VPN_PORT_FORWARDING_PROVIDER=protonvpn

Multi hop regions

Simply set the SERVER_HOSTNAMES environment variable to a hostname corresponding to a multi hop region (see Servers).

For example setting SERVER_HOSTNAMES=ch-us-01a.protonvpn.com would set a multi hop with entry in Switzerland and exit in the US.

Moderate NAT/NAT Type 2

Paid ProtonVPN subscribers can optionally use Moderate NAT on their connections.

To do so, the OpenVPN username assigned by ProtonVPN should have +nr appended to the end of it.

Servers

To see a list of servers available, list the VPN servers with Gluetun.