# VPNSentinel Server

VPNSentinel Server is a monitoring container that collects keepalives from VPNSentinel clients in VPN containers, displays a traffic-light dashboard for VPN, DNS leak, and bypass status, and sends Telegram alerts so. It is open source and self-hosted, installable on Unraid and Docker Hub.

Canonical page: https://ourlocalhost.com/app/7618/vpnsentinel-server

## Description

VPNSentinel Server is a monitoring container that collects keepalives from VPNSentinel clients in VPN containers, displays a traffic-light dashboard for VPN, DNS leak, and bypass status, and sends Telegram alerts so homelab users know immediately when traffic bypasses the VPN.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

50/100 (Fair), based on 3 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)

## Links

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

## Common questions

### Can I store the API key, Telegram credentials, and Apprise URLs in files instead of environment variables?

Yes. The API key, Telegram credentials, metrics token, and Apprise URLs can each be read from a file using *_FILE variables or Docker secrets.

### What alert destinations can VPNSentinel use besides Telegram?

It can send the same alerts to ntfy, Gotify, Discord, email, and 100+ other services through Apprise.

### When does the server report a VPN bypass?

It sends a critical red alert when VPN traffic is not routing through the VPN.

### What DNS-related failure does it detect?

It performs DNS leak detection and reports DNS queries that expose your location by bypassing the VPN.

### Can one VPNSentinel server monitor several VPN clients?

Yes, it supports monitoring unlimited VPN clients from a single server.

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