mirror of
https://github.com/ngoduykhanh/wireguard-ui.git
synced 2025-04-19 19:59:13 +03:00
Create README.md
This commit is contained in:
parent
d026c0ff4a
commit
679dfb39e8
1 changed files with 58 additions and 0 deletions
58
README.md
Normal file
58
README.md
Normal file
|
@ -0,0 +1,58 @@
|
||||||
|
# wireguard-ui
|
||||||
|
A web user interface to manage your WireGuard setup.
|
||||||
|
|
||||||
|
## Features
|
||||||
|
- Friendly UI
|
||||||
|
- Authentication
|
||||||
|
- Manage extra client's information (name, email, etc)
|
||||||
|
- Retrieve configs using QR code / file
|
||||||
|
|
||||||
|
## Run WireGuard-UI
|
||||||
|
Only docker option for now, please refer to this example of [docker-compose.yml](https://github.com/ngoduykhanh/wireguard-ui/blob/master/docker-compose.yaml).
|
||||||
|
|
||||||
|
Please adjust volume mount points to work with your setup. Then run it:
|
||||||
|
|
||||||
|
```
|
||||||
|
docker-compose up
|
||||||
|
```
|
||||||
|
|
||||||
|
## Auto restart WireGuard daemon
|
||||||
|
WireGuard-UI only takes care of configuration generation. You can use systemd to watch for the changes and restart the service. Following is an example:
|
||||||
|
|
||||||
|
Create /etc/systemd/system/wgui.service
|
||||||
|
|
||||||
|
```
|
||||||
|
[Unit]
|
||||||
|
Description=Restart WireGuard
|
||||||
|
After=network.target
|
||||||
|
|
||||||
|
[Service]
|
||||||
|
Type=oneshot
|
||||||
|
ExecStart=/usr/bin/systemctl restart wg-quick@wg0.service
|
||||||
|
```
|
||||||
|
|
||||||
|
Create /etc/systemd/system/wgui.path
|
||||||
|
|
||||||
|
```
|
||||||
|
[Unit]
|
||||||
|
Description=Watch /etc/wireguard/wg0.conf for changes
|
||||||
|
|
||||||
|
[Path]
|
||||||
|
PathModified=/etc/wireguard/wg0.conf
|
||||||
|
|
||||||
|
[Install]
|
||||||
|
WantedBy=multi-user.target
|
||||||
|
```
|
||||||
|
|
||||||
|
Apply it
|
||||||
|
```
|
||||||
|
systemctl enable wgui.{path,service}
|
||||||
|
systemctl start wgui.{path,service}
|
||||||
|
```
|
||||||
|
|
||||||
|
## Screenshot
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
## License
|
||||||
|
MIT. See [LICENSE](https://github.com/ngoduykhanh/wireguard-ui/blob/master/LICENSE).
|
Loading…
Add table
Reference in a new issue