Gluetun
VPNNetwork
VPN control server integration for Homarr's VPN widget.
Gluetun exposes a control server that Homarr can query to report the VPN tunnel status and public IP address in the VPN widget. DNS and provider details remain unavailable. Location appears only when Gluetun supplies it.
Widgets & Capabilities
VPNMonitor the connection status, public IP, and provider details of your VPN integrations.
Setting up the Gluetun control server
Refer to the Gluetun control server documentation to enable and configure authentication.
A read-only role granting GET /v1/vpn/status and GET /v1/publicip/ip is sufficient.
Homarr does not need access to VPN settings or your VPN-provider credentials.
Adding the integration
Create the connection under Management → Integrations. See Managing integrations.
Secrets
Use a control-server API key or HTTP Basic credentials that match your Gluetun authentication role.
No credentials required
This integration does not require any credentials to be set.