Gluetun
Gluetun is a feature-packed VPN client in a thin Docker container for many VPN providers, written in Go and using OpenVPN or WireGuard, DNS over TLS, and…
Platform availability
Available on 3 of 10 platforms
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.
85/100 Excellent
- Maintained
- 100last commit 23 days ago
- Popular
- 8415,976 GitHub stars
- Easy to install
- 553 install platforms, install notes, Docker image
- Light to run
- No data
Based on 3 of 4 factors.
Availability: platform listings confirmed today, links checked 8 days ago
- GitHub stars
- 15,976
- Open issues
- 354
- Last commit
- 2026-10-29
- Latest release
- v3.41.3
- License
- MIT
- Activity
- declining
Checked 17 days ago - source: GitHub (qdm12/gluetun)
Resources & Compatibility
ARM (e.g. Raspberry Pi) is supported.
Checked 54 days ago - source: Docker Hub image tags and published docs
First-install notes
- Give it VPN network access In your Docker settings, add NET_ADMIN and map /dev/net/tun (the virtual network device). Without this, Gluetun cannot create the tunnel that routes traffic through the VPN. source
- Set provider and VPN credentials Tell Gluetun which VPN service to use and enter the username/password or WireGuard private key details from your provider. If these are missing or wrong, the container may start but won’t connect to the VPN. source
- Fix SELinux if TUN errors appear If the container fails to access /dev/net/tun on an SELinux-enabled Linux host, install the SELinux policy module from the docs. This stops the security system from blocking the virtual device the VPN needs. source
Fetched 54 days ago - each note links to its source
Variants
Alternatives
No alternatives collected yet.
Common questions
What Docker access does Gluetun need to create a VPN tunnel?
Add NET_ADMIN to the container and map the host device /dev/net/tun. Without that mapping, Gluetun cannot create the virtual network device used to route traffic through the VPN.
Why does the Gluetun container start but not connect to the VPN?
Verify the provider and VPN credentials are correct. If the username/password or WireGuard private key details are missing or wrong, the container may start but fail to connect.
How can I fix TUN device errors on an SELinux host?
Install the SELinux policy module described in the Gluetun docs. This stops SELinux from blocking the container from accessing /dev/net/tun.
What should I check first when Gluetun is misbehaving?
Check the logs, since they contain multiple types of messages. Also review common operational topics such as DNS configuration, VPN provider selection, server updates, and firewall rules.
Answers sourced from deepwiki.com, deepwiki.com, deepwiki.com, deepwiki.com
Community
- Gluetun performance issues? : r/selfhosted - Reddit (reddit)
- Gluetun VPN recommandation for qBittorrent client : r/selfhosted - Reddit (reddit)
- Gluetun and qBittorrent correct setup in docker-compose file - Reddit (reddit)
- Can someone explain why gluetun is better over a normal ... - Reddit (reddit)
- gluetun - Reddit (reddit)
- Gluetun, Docker, and trying to understand VPNs : r/selfhosted - Reddit (reddit)
Collected 48 days ago - public community threads