WireGuard Watchdog

WireGuard Watchdog is an Unraid plugin that keeps a configured WireGuard tunnel healthy for homelab and server users.

  • Monitoring & Logging
  • Network Services
  • Plugins
  • Tools & Utilities
WireGuard Watchdog is an Unraid plugin that keeps a configured WireGuard tunnel healthy for homelab and server users. It pings a peer through the tunnel on a schedule, resets peer state with wg syncconf when needed, and restarts the tunnel as a last resort. It is useful when you need automatic recovery without manually managing WireGuard interfaces.

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

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

Collected 48 days ago - public community threads