WireGuard Easy – Home Assistant Integration

Custom integration for Home Assistant that connects to the WireGuard Easy (wg-easy) API and exposes peers as devices with sensors and binary sensors.

Source project

https://github.com/wg-easy/wg-easy

---

Installation

Installation via HACS

1. Add this repository as a custom repository to HACS:

2. Use HACS to install the integration.
3. Restart Home Assistant.
4. Set up the integration using the UI:

Manual Installation

1. Download the integration files from the GitHub repository.
2. Place the integration folder in the custom_components directory of Home Assistant.
3. Restart Home Assistant.
4. Set up the integration using the UI:

Setup

1. Go to Settings → Devices & Services
2. Click "Add Integration"
3. Select WG Easy
4. Enter:
   • API URL
   • API Token

---

Features

• Automatic peer discovery
• Dynamic device creation/removal
• Peer-level monitoring
• Transfer statistics (RX/TX, rates)
• Configurable online detection
• WireGuard server overview

---

License

This project is free to use, modify, and distribute.

Author: metaathron
Please retain attribution and link to the original repository: https://github.com/metaathron/ha-wgeasy