WireGuard Watchdog
WireGuard Watchdog is an Unraid plugin that keeps a configured WireGuard tunnel healthy for homelab and server users.
Platform availability
Available on 1 of 10 platforms
- Unraid
- TrueNAS (not listed)
- Umbrel (not listed)
- ZimaOS (not listed)
- Proxmox (not listed)
- Helm (not listed)
- Mac (not listed)
- Windows (not listed)
- Linux (not listed)
- Any server (not listed)
Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.
30/100 Low
- Maintained
- 52last commit 206 days ago
- Popular
- 00 GitHub stars
- Easy to install
- 251 install platform, install notes
- Light to run
- No data
Based on 3 of 4 factors.
Availability: platform listings confirmed today, links checked 4 days ago
- GitHub stars
- 0
- Open issues
- 1
- Last commit
- 2026-04-29
- Latest release
- 2026.04.29
- License
- MIT
- Activity
- stale
Checked 4 days ago - source: GitHub (pacnpal/wireguard-watchdog)
Resources & Compatibility
Requirements not published yet.
First-install notes
- Set required Docker options first Add NET_ADMIN, set PUID/PGID (the user and group IDs used for files), expose UDP 51820, mount a /config folder, and set the required sysctl net.ipv4.conf.all.src_valid_mark=1. Without these, the VPN will not start correctly or clients may not be able to connect. source
- Keep the /config folder safe Store your WireGuard tunnel files under /config/wg_confs and keep this folder backed up on a persistent volume. If it is lost, your tunnels and peer settings can disappear or need rebuilding. source
- Check the startup log After the container starts, look for lines showing found and activated tunnels, ending with “All tunnels are now active.” This confirms the settings were loaded and the VPN is actually running. source
- Requires Unraid WireGuard Requires Unraid's built-in WireGuard support and at least one configured tunnel, such as wg0 or wg1. source
- Enable built-in WireGuard first Enable Unraid's built-in WireGuard support (Settings → VPN > Manager) and configure at least one tunnel (wg0, wg1, …) before installing the plugin. source
Fetched 44 days ago - each note links to its source
Variants
Alternatives (12)
- Amnezia VPN - Enables classic, free, and self-hosted VPN modes, works under high censorship, uses a WireGuard-based protocol for better blocking resistan…
- Fossorial Pangolin - Open-source identity-based remote access platform using WireGuard, offering unified management, tunneled connections, granular access contr…
- LogMeIn Hamachi - Seamlessly connects devices and networks, extending LAN-like connectivity to mobile users and teams with a secure, hosted VPN service.
- OpenVPN Connect - OpenVPN Connect provides flexible VPN solutions to secure your data communications, whether it's for Internet privacy, remote access for em…
- Outline VPN - Journalists need safe access to information to research issues, communicate with sources, and report the news.
- Shadowsocks - Shadowsocks is a self-hosted SOCKS5 proxy that uses the open-source Shadowsocks encryption protocol.
- SoftEther VPN - SoftEther VPN ("SoftEther" means "Software Ethernet") is one of the world's most powerful and easy-to-use multi-protoco…
- Tailscale - Private networks made easy.
- WireGuard - WireGuard is a fast, lightweight virtual private network (VPN) server that creates encrypted point-to-point tunnels for secure remote acces…
- ZeroTier - ZeroTier is an open-source, cross-platform virtual LAN/VPN service that connects your devices and servers into one private network, so you…
- defguard - defguard is an SSO & VPN Server based on OpenID and WireGuard VPN with unique secure & private architecture for building secure and…
- nostr vpn - Nostr VPN turns your Umbrel into a private mesh VPN node for your own devices and trusted groups.
Checked 40 days ago - source: AlternativeTo
Common questions
How do I install the plugin on Unraid?
Open the Unraid Plugins tab, choose Install Plugin, paste the .plg URL, and click Install. It downloads the matching .txz package and installs it to the Unraid plugin directory.
Is the watchdog active immediately after installation?
No, it defaults to Enabled=no. You must open Tools to User Utilities to WireGuard Watchdog, fill in the form, set Enabled=yes, and click Apply before anything runs.
Does it interfere with Unraid's built-in WireGuard management?
It uses the same tools Unraid uses internally, primarily wg syncconf and only wg-quick as a last resort. The project states that the two coexist cleanly.
How does the check interval work when set below 60 seconds?
The minimum interval is 20 seconds. If the interval is below 60 seconds, the plugin uses per-minute cron lines with sleep offsets.
Where is the plugin's configuration and log data stored?
Its settings are written to /boot/config/plugins/wg-watchdog/wg-watchdog.cfg. The log file is /var/log/wg-watchdog.log, with a read-only display in the UI.
Answers sourced from github.com
Community
- self hosted VPN recommendations : r/WireGuard - Reddit (reddit)
- Improvement to wireguard_watchdog script? - OpenWrt Forum (forum)
- Home - WatchGuard Community (other)
- WireGuard vpn - WatchGuard Community (other)
- WireGuard VPN Watchdog? | SNBForums - SmallNetBuilder Forums (forum)
Collected 48 days ago - public community threads