mnaray
126 lines
4.5 KiB
Markdown
126 lines
4.5 KiB
Markdown
# WireGuard Easy
|
|
|
|
[](https://github.com/wg-easy/wg-easy/actions/workflows/deploy.yml)
|
|
[](https://github.com/wg-easy/wg-easy/actions/workflows/lint.yml)
|
|
[](https://github.com/wg-easy/wg-easy/stargazers)
|
|
[](LICENSE)
|
|
[](https://github.com/wg-easy/wg-easy/releases/latest)
|
|
[](https://github.com/wg-easy/wg-easy/pkgs/container/wg-easy)
|
|
|
|
You have found the easiest way to install & manage WireGuard on any Linux host!
|
|
|
|
<!-- TOOD: update screenshot -->
|
|
|
|
<p align="center">
|
|
<img src="./assets/screenshot.png" width="802" alt="wg-easy Screenshot" />
|
|
</p>
|
|
|
|
## Features
|
|
|
|
- All-in-one: WireGuard + Web UI.
|
|
- Easy installation, simple to use.
|
|
- List, create, edit, delete, enable & disable clients.
|
|
- Show a client's QR code.
|
|
- Download a client's configuration file.
|
|
- Statistics for which clients are connected.
|
|
- Tx/Rx charts for each connected client.
|
|
- Gravatar support.
|
|
- Automatic Light / Dark Mode
|
|
- Multilanguage Support
|
|
- One Time Links
|
|
- Client Expiration
|
|
- Prometheus metrics support
|
|
- IPv6 support
|
|
- CIDR support
|
|
- 2FA support
|
|
|
|
> [!NOTE]
|
|
> To better manage documentation for this project, it has its own site here: [https://wg-easy.github.io/wg-easy/latest](https://wg-easy.github.io/wg-easy/latest)
|
|
|
|
- [Getting Started](https://wg-easy.github.io/wg-easy/latest/getting-started/)
|
|
- [Basic Installation](https://wg-easy.github.io/wg-easy/latest/examples/tutorials/basic-installation/)
|
|
- [Caddy](https://wg-easy.github.io/wg-easy/latest/examples/tutorials/caddy/)
|
|
- [Traefik](https://wg-easy.github.io/wg-easy/latest/examples/tutorials/traefik/)
|
|
- [Podman](https://wg-easy.github.io/wg-easy/latest/examples/tutorials/podman-nft/)
|
|
- [AdGuard Home](https://wg-easy.github.io/wg-easy/latest/examples/tutorials/adguard/)
|
|
|
|
> [!NOTE]
|
|
> If you want to migrate from the old version to the new version, you can find the migration guide here: [Migration Guide](https://wg-easy.github.io/wg-easy/latest/advanced/migrate/)
|
|
|
|
## Installation
|
|
|
|
This is a quick start guide to get you up and running with WireGuard Easy.
|
|
|
|
For a more detailed installation guide, please refer to the [Getting Started](https://wg-easy.github.io/wg-easy/latest/getting-started/) page.
|
|
|
|
### 1. Install Docker
|
|
|
|
If you haven't installed Docker yet, install it by running as root:
|
|
|
|
```shell
|
|
curl -sSL https://get.docker.com | sh
|
|
exit
|
|
```
|
|
|
|
And log in again.
|
|
|
|
### 2. Run WireGuard Easy
|
|
|
|
The easiest way to run WireGuard Easy is with Docker Compose.
|
|
|
|
Just follow [these steps](https://wg-easy.github.io/wg-easy/latest/examples/tutorials/basic-installation/) in the detailed documentation.
|
|
|
|
You can also install WireGuard Easy with the [docker run command](https://wg-easy.github.io/wg-easy/latest/examples/tutorials/docker-run/) or via [podman](https://wg-easy.github.io/wg-easy/latest/examples/tutorials/podman-nft/).
|
|
|
|
Now [setup a reverse proxy](https://wg-easy.github.io/wg-easy/latest/examples/tutorials/basic-installation/#setup-reverse-proxy) to be able to access the Web UI securely from the internet. This step is optional, just make sure to follow the guide [here](https://wg-easy.github.io/wg-easy/latest/examples/tutorials/reverse-proxyless/) if you decide not to do it.
|
|
|
|
## Donate
|
|
|
|
Are you enjoying this project? Consider donating.
|
|
|
|
Founder: [Buy Emile a beer!](https://github.com/sponsors/WeeJeWel) 🍻
|
|
|
|
Maintainer: [Buy kaaax0815 a coffee!](https://github.com/sponsors/kaaax0815) ☕
|
|
|
|
## Development
|
|
|
|
### Prerequisites
|
|
|
|
- Docker
|
|
- Node LTS & corepack enabled
|
|
- Visual Studio Code
|
|
|
|
### Dev Server
|
|
|
|
This starts the development server with docker
|
|
|
|
```shell
|
|
pnpm dev
|
|
```
|
|
|
|
### Update Auto Imports
|
|
|
|
If you add something that should be auto-importable and VSCode complains, run:
|
|
|
|
```shell
|
|
cd src
|
|
pnpm install
|
|
cd ..
|
|
```
|
|
|
|
### Test Cli
|
|
|
|
This starts the cli with docker
|
|
|
|
```shell
|
|
pnpm cli:dev
|
|
```
|
|
|
|
## License
|
|
|
|
This project is licensed under the AGPL-3.0-only License - see the [LICENSE](LICENSE) file for details
|
|
|
|
This project is not affiliated, associated, authorized, endorsed by, or in any way officially connected with Jason A. Donenfeld, ZX2C4 or Edge Security
|
|
|
|
"WireGuard" and the "WireGuard" logo are registered trademarks of Jason A. Donenfeld
|