VPN Gateway

A self-hosted VPN gateway for homelab container traffic, built on hotio's Alpine VPN base, that adds nftables bandwidth limiting, scheduling, hot-reload, and…

  • Network Services
A self-hosted VPN gateway for homelab container traffic, built on hotio's Alpine VPN base, that adds nftables bandwidth limiting, scheduling, hot-reload, and a web UI.

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.

49/100 Fair

Maintained
82last commit 13 days ago
Popular
198 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
302.2998 GB minimum RAM

Availability: platform listings confirmed today, links checked 17 days ago

GitHub stars
8
Open issues
0
Last commit
2026-11-08
Latest release
v1.4.9
License
MIT
Activity
declining

Checked 5 days ago - source: GitHub (prophetse7en/vpn-gateway)

Resources & Compatibility

Minimum requirements: 2.2998 GB RAM.

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

First-install notes

  • Install the Proton VPN beta client Download and install the beta Proton VPN package, then install proton-vpn-gnome-desktop. This provides the app you'll use to sign in and start a VPN connection; without it, you have no client to use. source
  • Install OpenVPN Use your Linux distribution's command to install OpenVPN. It is the engine that creates the secure tunnel, so the VPN will not connect if this is missing. source
  • Optional: add port-forwarding helpers If you're running this as a VPN gateway, install py-natpmp or natpmpc, small tools that help your computer ask your router to forward a port. Without this, devices outside your home network may not be able to reach the gateway. source
  • First-boot setup First boot: open port 6050, follow /setup to create an admin account, and use the API key for Homepage or scripts. source
  • Web UI Open the web UI on port 6050 to configure rates, rules, and schedules. source

Fetched 43 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

How do I route my existing containers through the VPN?

Use vpn-gateway as a drop-in replacement for the hotio Alpine VPN base image. Attach other containers to its network namespace, for example by running them with --net=container:vpn-gateway.

Do I need to restart the container after changing bandwidth rules?

No. You can edit traffic.conf and the changes hot-reload within about 10 seconds without restarting the container.

Which port should I expose for the web UI?

Expose port 6050, open it in a browser, and use the /setup page to create an admin account. The API key can then be used for Homepage or scripts.

Should I pull the latest tag automatically?

No, use a pinned version tag rather than latest. A breaking update can leave containers routed through vpn-gateway disconnected until you fix or roll it back.

Does vpn-gateway recover if the underlying VPN connection reconnects?

Yes, a watchdog detects when hotio rebuilds its nftables table and re-applies the rate-limit rules.

Do traffic statistics survive container restarts?

Yes, traffic data survives container restarts. It is saved every 5 minutes and again on shutdown.

Answers sourced from github.com

Community

Collected 48 days ago - public community threads