ProtonVPN

Docker package of the official Proton VPN CLI with a Web UI and a shared VPN network for other containers.

  • Network Services
Docker package of the official Proton VPN CLI with a Web UI and a shared VPN network for other containers. It lets self-hosters run Proton VPN headless on a homelab and route the traffic of attached containers through it; Proton does not officially support unattended operation, so you sign in and manage settings from the browser.

Platform availability

Available on 1 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

48/100 Fair

Maintained
75last commit 12 days ago
Popular
123 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
502 GB minimum RAM

Availability: platform listings confirmed today

GitHub stars
3
Open issues
0
Last commit
2026-11-09
Latest release
v0.1.0
License
GPL-3.0
Activity
rising

Checked 12 days ago - source: GitHub (andrebrait/protonvpn-cli-docker)

Resources & Compatibility

Minimum requirements: 2 GB RAM, 200 MB disk.

Checked 12 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Sign in before connecting Run protonvpn signin with your ProtonVPN username, then confirm your password and TOTP (the rotating login code) or security key if your account uses two-step verification; if you skip this, connect and status commands will not authenticate and the VPN will not start. source
  • Choose the location you want Use protonvpn connect with a country or city, such as --country US, so your traffic leaves from a place you intentionally selected; otherwise ProtonVPN may connect to its fastest global server, which might not match the media, speed, or service location you need. source
  • Restart after DNS changes If you turn on custom DNS (DNS is how devices turn website names into address numbers) with protonvpn config set custom-dns, establish a new VPN connection after the change; without reconnecting, the CLI keeps using the old DNS setup, so ad, tracker, or malware blocking may not apply. source
  • Set a WebUI password Set a web-user password before exposing the interface; leaving it empty allows anyone on the network to open the WebUI even when API_KEY is set. FIDO2 sign-in is console-only and not verified. source
  • Route other containers Attach other containers with --network=container:protonvpn and publish their application ports on this VPN container; set LAN_NETWORKS to your trusted LAN CIDRs for direct access to those applications. source
  • Attached container capabilities Drop NET_RAW (--cap-drop=NET_RAW) from attached containers, never grant them NET_ADMIN, and start them only after this container is healthy; if the VPN container is recreated, recreate the attached containers to rejoin its new network namespace. source

Fetched 12 days ago - each note links to its source

Alternatives (12)

  • Amnezia VPN - Enables classic, free, and self-hosted VPN modes, works under high censorship, uses a WireGuard-based protocol for better blocking resistan…
  • Geph - Geph is a tool that helps you bypass internet blocks and censorship.
  • Hotspot Shield - Secure fast VPN to protect identity and hide location.
  • Mullvad VPN - Free the internet from data collection with Mullvad VPN – a service that helps keep your online activity, identity, and location private.
  • NordVPN - A minimal, shell-free, actively rebuilt container for the official NordVPN Linux client that gives self-hosted services a shared Virtual Pr…
  • NymVPN - Decentralized VPN with mixnet and zero-knowledge encryption, offering fast WireGuard and censorship-resistant AmneziaWG modes while hiding…
  • Obscura VPN - Anonymous VPN service with no IP or traffic logs, privacy-focused logins using random accounts, payments via Bitcoin's Lightning Network, a…
  • Outline VPN - Journalists need safe access to information to research issues, communicate with sources, and report the news.
  • Private Internet Access - Encrypts online activity, provides anonymous IPs, has a strict no-logs policy, open-source VPN protocols, large server network, fast speeds…
  • Psiphon - Secure and high-performance, Psiphon provides open access to the uncensored internet for millions of people around the world, with 150,000,…
  • Throne VPN
  • Tor VPN - A VPN that offers network-level privacy by routing mobile app traffic through Tor, enables per-app routing for independent circuits, and by…

Checked 12 days ago - source: AlternativeTo

Common questions

Should I set a WebUI password for the Proton VPN container?

Yes, set a WebUI password before exposing the interface. Leaving it empty enables open access even if API_KEY is set.

How do I attach another Docker container to the same Proton VPN connection?

Attach the app container with --network=container:protonvpn and publish its application ports on the protonvpn container. Set LAN_NETWORKS to your trusted LAN CIDRs if direct application access is needed.

Does the VPN container need privileged mode or host networking?

No, do not use privileged mode or host networking. The VPN container needs NET_ADMIN, a TUN device, and net.ipv4.conf.all.src_valid_mark=1.

Can the Docker host and container use different iptables backends?

Yes, a legacy iptables host can use an nftables-based container without that being a compatibility problem. This has been measured on Unraid 7.3.4 and is not support for every Unraid or Docker version.

How are updates to the official Proton VPN CLI handled?

Each build pins one reviewed Proton release. A new release is adopted by changing the CLI and API pins after testing, not by merely rebuilding.

Answers sourced from github.com

Community

Collected 12 days ago - public community threads