https://github.com/wg-easy/wg-easy
The easiest way to run WireGuard VPN + Web-based Admin UI.
https://github.com/wg-easy/wg-easy
Last synced: 27 days ago
JSON representation
The easiest way to run WireGuard VPN + Web-based Admin UI.
- Host: GitHub
- URL: https://github.com/wg-easy/wg-easy
- Owner: wg-easy
- License: agpl-3.0
- Created: 2021-05-22T09:12:05.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2026-05-13T07:22:01.000Z (about 1 month ago)
- Last Synced: 2026-05-13T09:09:43.226Z (about 1 month ago)
- Language: TypeScript
- Homepage: https://wg-easy.github.io/wg-easy/latest/
- Size: 7.96 MB
- Stars: 25,675
- Watchers: 136
- Forks: 2,437
- Open Issues: 34
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: contributing.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
- RAWR - wg-easy - The easiest way to run WireGuard VPN + Web-based Admin UI. (Other / Webapps)
- awesome-starred - wg-easy/wg-easy - The easiest way to run WireGuard VPN + Web-based Admin UI. (others)
- StarryDivineSky - wg-easy/wg-easy - easy项目提供了一种简便的方式来运行 WireGuard VPN，并提供基于 Web 的管理用户界面。它旨在简化 WireGuard VPN 的设置和管理过程，无需复杂的命令行操作。该项目的主要特色是易于使用，用户可以通过 Web UI 轻松配置和管理 VPN 连接。wg-easy 简化了 WireGuard 的密钥生成、客户端配置和连接管理等任务。通过 Docker 容器化部署，可以快速启动和运行 VPN 服务。Web UI 提供了直观的操作界面，方便用户添加、删除和管理 VPN 客户端。该项目适用于希望快速搭建和管理 WireGuard VPN，但又不想深入研究底层配置的用户。总而言之，wg-easy 提供了一个用户友好的 WireGuard VPN 解决方案，降低了 VPN 部署和管理的门槛。 (网络信息服务 / 网络代理)
- definitive-opensource - WireGuard Easy - based Admin UI. | `SelfHost` | **25.9k** | (Table of Contents / VPN)
- awesome-starts - wg-easy/wg-easy - The easiest way to run WireGuard VPN + Web-based Admin UI. (others)
- awesome-sysadmin-tools - wg-easy - The easiest way to install & manage WireGuard on any Linux host! (Security)
- awesome-wireguard - wg-easy/wg-easy - The easiest way to run WireGuard VPN + Web-based Admin UI. (Projects / User Interface)
README
# 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!
## 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
- Per-client firewall filtering (requires iptables)
> [!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