Skip to content

Troubleshooting Guide

BrodjagaRatnik edited this page Jun 9, 2026 · 3 revisions

❓ Troubleshooting Guide

VPN Disconnects on Stop

Ensure Manual Session mode is active (this is automatically set when connecting via the VPN Menu). Note that Smart Auto-Mappings (Triggers) will override a manual session if a specific addon mapping is matched.

Watchdog not starting

Run systemctl status vpn-watchdog.service via SSH to check for errors. The service is standalone and does not require Kodi to be running. If it shows "failed", check the logs using journalctl.

DNS Leaks

The addon forces a hardened resolv.conf. If you lose internet connectivity after a system crash, the addon will automatically restore defaults upon the next successful startup.

Watchdog Status: "Initializing"

This status means the service is waiting for a valid IP address from your router. It will switch to "Active" automatically once the physical network interface is ready.

F11 Key Not Working

  • Restart: Ensure a full reboot has occurred since the initial setup.
  • Check File: Verify the keymap exists at: /storage/.kodi/userdata/keymaps/wireguard_manager_key.xml

screenshot00001.jpg

Clone this wiki locally