# Gluetun Companion

Gluetun Companion is a self-hosted web UI that manages an existing Gluetun VPN container from the browser. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/2852/gluetun-companion

## Description

Gluetun Companion is a self-hosted web UI that manages an existing Gluetun VPN container from the browser. It provides a server catalogue with speed benchmarks, scheduled and manual VPN switches, automatic recreation of Docker containers that depend on the VPN, port forwarding rules, qBittorrent and rTorrent synchronization, and Prometheus metrics. It is aimed at homelab users who run Gluetun on Docker or Unraid and want day-to-day VPN control without shell access.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

69/100 (Good), based on 4 of 5 factors.
- Maintained: 100 (last commit 7 days ago)
- Popular: 24 (15 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Security check: 95 (no serious findings, CI, tests)

## Links

- Unraid: https://ca.unraid.net/apps/gluetun-companion-0uhgrhz0byhtpv?q=gluetun-companion

## Common questions

### What special setup does the Unraid template require?

It intentionally runs as root and needs read/write access to /boot/config/plugins/dockerMan/templates-user. This is required because DockerMan templates are root-owned and mode 600, and PUID/PGID would break template write-back unless host permissions are changed manually.

### Why does the companion need access to the Docker socket?

It uses the Docker socket to inspect and recreate the Gluetun container. It also needs it to manage running network dependents.

### Can the companion benchmark VPN servers without restarting Gluetun?

Yes, it can benchmark from the VPN tunnel itself in sidecar mode without restarting Gluetun. It can also use the integrated HTTP proxy and measures throughput, latency, jitter, packet loss, DNS, history, and stability.

### Can it rotate servers without running benchmarks?

Yes, rotation pools can change servers randomly, round-robin, or by best historical speed. This works without benchmarking.

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