Skip to content

Diagnostics

Stefano Bertelli edited this page Apr 3, 2026 · 1 revision

Diagnostics

The Diagnostics page (/admin/diagnostics) provides system health monitoring and troubleshooting tools.

Diagnostics Page

WireGuard Interface

Displays the current state of the WireGuard interface:

Field Description
Interface Interface name (default: wg0)
Status Enabled or disabled
IPv4 Network Configured IPv4 tunnel subnet
IPv6 Network Configured IPv6 tunnel subnet
Endpoint Public endpoint address and port

Active Peers

Lists all WireGuard peers that have had a recent handshake, sourced from the database. The table shows:

Column Description
Device Name Friendly name of the device
Public Key WireGuard public key
IPv4 Tunnel IP address
Remote IP Client's real IP address (from last handshake)
Last Handshake Timestamp of most recent handshake
RX / TX Traffic statistics

This view is useful for verifying which devices are actively connected to the VPN.

WAN Connectivity Checks

WireGUI periodically performs outbound connectivity checks to verify the server has internet access. Results are displayed in a table showing:

  • Timestamp - When the check was performed
  • URL - The endpoint tested
  • Status - HTTP status code
  • Response - Response details or error message

These checks help diagnose issues where the VPN server itself has lost upstream connectivity.

System Notifications

Displays recent system notifications such as:

  • Interface state changes
  • Peer configuration events
  • Error conditions
  • Background task status updates

Notifications are stored in-memory and reset on application restart.

Clone this wiki locally