Manual Commands, Cleanup

💻 Manual Commands (SSH)

If you need to manage the service or troubleshoot via terminal, use these commands:

Service Management

Check the status of the background watchdog

systemctl status vpn-watchdog.service

Restart the watchdog

systemctl restart vpn-watchdog.service

Monitor watchdog logs in real-time

journalctl -u vpn-watchdog.service -f

🛠 Advanced Tuning

All performance timings are centralized in resources/lib/vpn_config.py. Users on high-performance hardware like the Raspberry Pi 5 can adjust variables like PROP_SYNC_DELAY and OS_RELEASE_DELAY to achieve near-instantaneous connection swaps.

🧹 Manual Cleanup & Uninstallation

If you uninstalled the addon without performing a Factory Reset from the settings menu, run these commands via SSH to completely clean your system:

# 1. Stop and remove Watchdog service
systemctl stop vpn-watchdog.service
systemctl disable vpn-watchdog.service
rm /storage/.config/system.d/vpn-watchdog.service

# 2. Remove ConnMan network priority config
rm /storage/.config/connman_main.conf
systemctl restart connman

# 3. Remove keymaps and WireGuard configs
rm /storage/.kodi/userdata/keymaps/wireguard_manager_key.xml
rm -f /storage/.config/wireguard/*_*.config

# 4. Refresh system services
systemctl daemon-reload