wg-easy
wg-easy runs a WireGuard VPN. This shows connected, enabled and disabled clients, and data received and sent.
Set it up
Section titled “Set it up”Sign-in: A username and password.
integrations: wg-easy: type: wg-easy url: http://wg-easy:8080 username: ${WG_EASY_USER} password: ${WG_EASY_PASSWORD}
layout: - title: Network widgets: - wg-easy.status| Option | Type | Default | What it does |
|---|---|---|---|
url | URL | required | Where the service answers, from Valet’s side. |
href | string | optional | Where the card links to, when that differs from url. |
every | string or number | optional | How often to refresh while someone is looking: seconds, or 30s, 5m, 1h. |
insecure | boolean | optional | Accept a self-signed certificate for this service only. |
username | string | required | The account to sign in with. |
password | string | required | That account’s password. Use ${VAR}. |
Widgets
Section titled “Widgets”One widget. Its key is wg-easy.status, using the instance name from your config.
wg-easy
Section titled “wg-easy”wg-easy.status · stats card · refreshes every minute while the page is open.
Tall draws the same as medium, so it isn't shown. Only the empty space changes.
States
Section titled “States”Assistant tools
Section titled “Assistant tools”What the assistant can use, once its access level allows it. Read tools run freely. Everything else asks first.
| Tool | Access | What it does |
|---|---|---|
wg_easy_status | read | What wg-easy reports right now: Connected, Enabled, Disabled, Received, Sent. |





