Skip to content

Devices

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

Devices

The Devices page is the main screen for managing your WireGuard VPN devices. Each user sees only their own devices.

Device List

Devices Page

The device table displays:

Column Description
Status Color-coded connection indicator (green = connected, yellow = recent, red = disconnected)
Name Device name and optional description
IPv4 Assigned IPv4 tunnel address
IPv6 Assigned IPv6 tunnel address
Public Key Truncated WireGuard public key
RX / TX Received and transmitted bytes
Last Handshake Timestamp of the last WireGuard handshake

The table auto-refreshes every 5 seconds to show live connection status and traffic statistics.

Click on any device row to open the device detail page with expanded information, traffic charts, and configuration management.

Creating a Device

Click Add Device to open the creation dialog.

Add Device Dialog

Fields

  • Device Name (required) - A friendly name for the device (e.g., "MacBook Pro", "Phone")
  • Description (optional) - Additional notes about the device

Configuration Overrides

By default, new devices inherit the global client defaults configured in Settings. You can override any setting per-device by unchecking the corresponding "Use default" toggle:

  • Allowed IPs - IP ranges routed through the tunnel (default: 0.0.0.0/0, ::/0 for full tunnel)
  • DNS - DNS servers the client should use
  • Endpoint - Server hostname/IP and port
  • MTU - Maximum Transmission Unit (default: 1280)
  • Persistent Keepalive - Keepalive interval in seconds (default: 25)

After Creation

When a device is created, WireGUI:

  1. Generates a WireGuard keypair and preshared key
  2. Allocates the next available IPv4 and IPv6 addresses from the configured network ranges
  3. Displays the client configuration with a QR code for easy mobile setup
  4. Offers a download button for the .conf file
  5. Configures the WireGuard peer and firewall rules in the background

Important: The private key is shown only once at creation time. It is not stored on the server. Make sure to save or scan the configuration immediately.

Device Detail Page

Clicking a device row opens its detail page, which shows:

  • Device Info - Public key, IPv4/IPv6 addresses, creation date
  • Traffic Statistics - RX/TX bytes and rates, last handshake time, remote IP
  • Live Traffic Chart - Real-time graph of traffic rates (updates every 5 seconds, 60-point rolling history)
  • Active Configuration - The current WireGuard client configuration
  • Edit Form - Update device name, description, and configuration overrides
  • Danger Zone - Delete the device (with confirmation)

Clone this wiki locally