You have found the easiest way to install & manage AmneziaWG on any Linux host!

• AmneziaWG obfuscation parameters support (Jc, Jmin, Jmax, S1-S4, H1-H4, I1-I5, J1-J3, Itime)
• Parameter constraints validation and random generation on first run, every install will be unique
• Adaptive UI theme that detects AmneziaWG vs WireGuard and switches branding accordingly
• Automatic fallback to standard WireGuard when AmneziaWG kernel module is not available

This project is a fork of wg-easy

• All-in-one: AmneziaWG + 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

• Getting Started
• Basic Installation
• Caddy
• Traefik
• Podman
• AdGuard Home

This is a quick start guide to get you up and running with AmneziaWG Easy.

For a more detailed installation guide, please refer to the Getting Started page.

If you haven't installed Docker yet, install it by running as root:

curl -sSL https://get.docker.com | sh
exit

And log in again.

The easiest way to run AmneziaWG Easy is with Docker Compose.

Just follow these steps in the detailed documentation.

You can also install AmneziaWG Easy with the docker run command or via podman.

Now setup a 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 if you decide not to do it.

Are you enjoying this project? Consider donating.

Founder: Buy Emile a beer! 🍻

Maintainer: Buy kaaax0815 a coffee! ☕

• Docker
• Node LTS & corepack enabled
• Visual Studio Code

This starts the development server with docker

pnpm dev

If you add something that should be auto-importable and VSCode complains, run:

cd src
pnpm install
cd ..

This starts the cli with docker

pnpm cli:dev

This project is licensed under the AGPL-3.0-only License - see the 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