@@ -8,11 +8,13 @@
|
||||
|
||||
You have found the easiest way to install & manage WireGuard on any Linux host!
|
||||
|
||||
<!-- markdownlint-disable MD033 -->
|
||||
<p align="center">
|
||||
<img src="./assets/screenshot.png" width="802" />
|
||||
<img src="./assets/screenshot.png" alt="screenshot" width="802" />
|
||||
</p>
|
||||
|
||||
## Features
|
||||
|
||||
* All-in-one: WireGuard + Web UI.
|
||||
* Easy installation, simple to use.
|
||||
* List, create, edit, delete, enable & disable clients.
|
||||
@@ -26,6 +28,7 @@ You have found the easiest way to install & manage WireGuard on any Linux host!
|
||||
* UI_TRAFFIC_STATS (default off)
|
||||
* UI_SHOW_LINKS (default off)
|
||||
* WG_ENABLE_EXPIRES_TIME (default off)
|
||||
* Prometheus metrics support
|
||||
|
||||
## Requirements
|
||||
|
||||
@@ -34,7 +37,7 @@ You have found the easiest way to install & manage WireGuard on any Linux host!
|
||||
|
||||
## Versions
|
||||
|
||||
We provide more then 1 docker image to get, this will help you decide which one is best for you. <br>
|
||||
We provide more then 1 docker image to get, this will help you decide which one is best for you. <br\>
|
||||
For **stable** versions instead of nightly or development please read **README** from the **production** branch!
|
||||
|
||||
| tag | Branch | Example | Description |
|
||||
@@ -62,7 +65,7 @@ And log in again.
|
||||
|
||||
To automatically install & run wg-easy, simply run:
|
||||
|
||||
```
|
||||
```bash
|
||||
docker run -d \
|
||||
--name=wg-easy \
|
||||
-e LANG=de \
|
||||
@@ -87,6 +90,8 @@ To automatically install & run wg-easy, simply run:
|
||||
|
||||
The Web UI will now be available on `http://0.0.0.0:51821`.
|
||||
|
||||
The Prometheus metrics will now be available on `http://0.0.0.0:51821/metrics`. Grafana dashboard [21733](https://grafana.com/grafana/dashboards/21733-wireguard/)
|
||||
|
||||
> 💡 Your configuration files will be saved in `~/.wg-easy`
|
||||
|
||||
WireGuard Easy can be launched with Docker Compose as well - just download
|
||||
@@ -109,7 +114,7 @@ These options can be configured by setting environment variables using `-e KEY="
|
||||
| `WG_HOST` | - | `vpn.myserver.com` | The public hostname of your VPN server. |
|
||||
| `WG_DEVICE` | `eth0` | `ens6f0` | Ethernet device the wireguard traffic should be forwarded through. |
|
||||
| `WG_PORT` | `51820` | `12345` | The public UDP port of your VPN server. WireGuard will listen on that (othwise default) inside the Docker container. |
|
||||
| `WG_CONFIG_PORT`| `51820` | `12345` | The UDP port used on [Home Assistant Plugin](https://github.com/adriy-be/homeassistant-addons-jdeath/tree/main/wgeasy)
|
||||
| `WG_CONFIG_PORT`| `51820` | `12345` | The UDP port used on [Home Assistant Plugin](https://github.com/adriy-be/homeassistant-addons-jdeath/tree/main/wgeasy)
|
||||
| `WG_MTU` | `null` | `1420` | The MTU the clients will use. Server uses default WG MTU. |
|
||||
| `WG_PERSISTENT_KEEPALIVE` | `0` | `25` | Value in seconds to keep the "connection" open. If this value is 0, then connections won't be kept alive. |
|
||||
| `WG_DEFAULT_ADDRESS` | `10.8.0.x` | `10.6.0.x` | Clients IP address range. |
|
||||
@@ -126,7 +131,7 @@ These options can be configured by setting environment variables using `-e KEY="
|
||||
| `UI_SHOW_LINKS` | `false` | `true` | Enable display of a short download link in Web UI |
|
||||
| `MAX_AGE` | `0` | `1440` | The maximum age of Web UI sessions in minutes. `0` means that the session will exist until the browser is closed. |
|
||||
| `UI_ENABLE_SORT_CLIENTS` | `false` | `true` | Enable UI sort clients by name |
|
||||
|
||||
| `ENABLE_PROMETHEUS_METRICS` | `true` | `true` | Enable Prometheus metrics `http://0.0.0.0:51821/metrics` and `http://0.0.0.0:51821/metrics/json`|
|
||||
|
||||
> If you change `WG_PORT`, make sure to also change the exposed port.
|
||||
|
||||
|
||||
Reference in New Issue
Block a user