# VPNSentinel Client

VPNSentinel Client is a lightweight monitoring container that attaches to an existing virtual private network (VPN) container such as Gluetun and checks, every five minutes by default, whether traffic really goes. It is open source and self-hosted, installable on Unraid and Docker Hub.

Canonical page: https://ourlocalhost.com/app/7619/vpnsentinel-client

## Description

VPNSentinel Client is a lightweight monitoring container that attaches to an existing virtual private network (VPN) container such as Gluetun and checks, every five minutes by default, whether traffic really goes through the VPN and whether Domain Name System (DNS) queries leak. It reports results to a VPNSentinel server, giving homelab operators of WireGuard or OpenVPN containers a traffic-light dashboard status and instant Telegram alerts when their tunnel fails.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

45/100 (Fair), based on 4 of 4 factors.
- Maintained: 88 (last commit 9 days ago)
- Popular: 0 (0 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Light to run: 20 (16 GB minimum RAM, runs on ARM)

## Links

- Unraid: https://ca.unraid.net/apps/app_f12d341ab3075906
- GitHub: https://github.com/agigante80/VPNSentinel
- Docker Hub: https://hub.docker.com/r/agigante80/vpn-sentinel-client

## Common questions

### How do I attach the VPNSentinel client to the VPN container it should monitor?

In the client's Extra Parameters, replace the network flag with --network=container:NAME, where NAME is the exact name of the VPN container. The client must run in that same network namespace.

### Why does the client log “Failed to send keepalive” and not show on the dashboard?

The VPN container may be blocking traffic to the host. Set FIREWALL_OUTBOUND_SUBNETS in the VPN container to include the host's LAN subnet.

### Which authentication settings does the client need?

It must use the same API key and the same API path as the VPNSentinel server.

### How often does the client report by default?

It reports every 5 minutes by default. The interval is controlled by VPN_SENTINEL_INTERVAL, in seconds.

## Alternatives

- RuTorrentVPN-plus-plus
- Throne VPN

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