# 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 built-in proxy servers. It is open source and self-hosted, installable on Docker Hub, Unraid, ZimaOS and Proxmox.

Canonical page: https://ourlocalhost.com/app/382/gluetun

## Description

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, ZimaOS, Proxmox.

## Health score

85/100 (Excellent), based on 3 of 4 factors.
- Maintained: 100 (last commit 23 days ago)
- Popular: 84 (15,976 GitHub stars)
- Easy to install: 55 (3 install platforms, install notes, Docker image)

## Links

- Docker Hub: https://hub.docker.com/r/qmcgaw/gluetun
- Unraid: https://ca.unraid.net/apps/gluetun-1qymtt21nperzu?q=gluetun
- GitHub: https://github.com/qdm12/gluetun
- ZimaOS: https://github.com/bigbeartechworld/big-bear-casaos/tree/master/Apps/gluetun
- Proxmox: https://community-scripts.github.io/ProxmoxVE/scripts?id=gluetun

## 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.

---
Source: Our Local Host (https://ourlocalhost.com/app/382/gluetun), the self-hosted and open-source app directory.
