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…

  • Network Services
  • Security
  • Tools & Utilities
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 built-in proxy servers.

Platform availability

Available on 3 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS
  • Proxmox
  • 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.

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

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

Collected 48 days ago - public community threads