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…
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
Variants
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
- Vpn gateway : r/selfhosted - Reddit (reddit)
- VPN Gateway vs VPN Tunnel? : r/selfhosted - Reddit (reddit)
- VPN Gateway Hardware : r/selfhosted - Reddit (reddit)
- Do you use a VPS gateway for your selfhosted services? - Reddit (reddit)
Collected 48 days ago - public community threads