# WG Easy

[WG Easy](https://github.com/wg-easy/wg-easy) is an all-in-one [WireGuard](https://www.wireguard.com/) VPN solution with a web-based management interface. It simplifies the installation and management of WireGuard, letting you create and manage VPN clients without touching the command line.

![WG Easy](https://etke.cc/img/extra-services/wg-easy/wg-easy.webp)

## Features

WG Easy gives you full control over your VPN clients: create, edit, delete, enable and disable them right from the web UI. Each client gets a downloadable configuration file and a QR code for quick mobile setup, along with connection statistics and Tx/Rx charts to monitor usage.

Security is covered with two-factor authentication (2FA), per-client firewall filtering rules, one-time links, and client expiration. WG Easy also supports IPv6 and CIDR configuration, Prometheus metrics for monitoring, and comes with dark/light mode and multi-language support.

## Usage

We install your WG Easy instance at a URL like: `https://vpn.your-server.com`

Open the URL in your browser to access the WG Easy web UI. From there, you can create and manage your VPN clients.

### Adding a VPN client

1. Open the WG Easy web UI at `https://vpn.your-server.com`
2. Click **New Client** and give it a name
3. The client will appear in the list with options to download its configuration or display a QR code

### Connecting to the VPN

To connect to your VPN, you need to install the official WireGuard client app on your device:

- [WireGuard for Windows](https://www.wireguard.com/install/)
- [WireGuard for macOS](https://apps.apple.com/us/app/wireguard/id1451685025)
- [WireGuard for Linux](https://www.wireguard.com/install/)
- [WireGuard for Android](https://play.google.com/store/apps/details?id=com.wireguard.android)
- [WireGuard for iOS](https://apps.apple.com/us/app/wireguard/id1441195209)

Once installed:

- **On mobile**: tap the QR code icon in the WG Easy web UI and scan it with the WireGuard app
- **On desktop**: download the configuration file from the WG Easy web UI and import it into the WireGuard app


---
* [llms.txt](https://etke.cc/llms.txt): full site index in markdown