From 303c2f1e393669c0717fc3a0c57e73178e6a4f78 Mon Sep 17 00:00:00 2001
From: Bernd Storath <32197462+kaaax0815@users.noreply.github.com>
Date: Sat, 16 Aug 2025 16:02:17 +0200
Subject: [PATCH] Docs: Add amneziawg (#2108)

add amneziawg docs
---
 docs/content/advanced/config/amnezia.md       | 37 +++++++++++++++++++
 .../advanced/config/experimental-config.md    |  9 +++++
 2 files changed, 46 insertions(+)
 create mode 100644 docs/content/advanced/config/amnezia.md
 create mode 100644 docs/content/advanced/config/experimental-config.md

diff --git a/docs/content/advanced/config/amnezia.md b/docs/content/advanced/config/amnezia.md
new file mode 100644
index 00000000..bdead28b
--- /dev/null
+++ b/docs/content/advanced/config/amnezia.md
@@ -0,0 +1,37 @@
+---
+title: AmneziaWG
+---
+
+Experimental support for AmneziaWG can be enabled by setting the `EXPERIMENTAL_AWG` environment variable to `true`. This feature is still under development and may change in future releases.
+
+AmneziaWG adds multi-level transport-layer obfuscation by:
+
+- Modifying packet headers
+- Randomizing handshake message sizes
+- Disguising traffic to resemble popular UDP protocols
+
+These measures make it harder for third parties to analyze or identify your traffic, enhancing both privacy and security.
+
+When enabled, wg-easy will automatically detect whether the AmneziaWG kernel module is available. If it is not, the system will fall back to the standard WireGuard module.
+
+To override this automatic detection, set the `OVERRIDE_AUTO_AWG` environment variable. By default, this variable is unset.
+
+Possible values:
+
+- `awg` — Force use of AmneziaWG
+- `wg` — Force use of standard WireGuard
+
+To be able to connect to wg-easy if AmneziaWG is enabled, you must have a AmneziaWG-compatible client.
+
+Android:
+
+- [AmneziaWG](https://play.google.com/store/apps/details?id=org.amnezia.awg) - Official Client
+- [WG Tunnel](https://play.google.com/store/apps/details?id=com.zaneschepke.wireguardautotunnel) - Third Party Client
+
+iOS and macOS:
+
+- [AmneziaWG](https://apps.apple.com/us/app/amneziawg/id6478942365) - Official Client
+
+Windows:
+
+- [AmneziaWG](https://github.com/amnezia-vpn/amneziawg-windows-client/releases) - Official Client
diff --git a/docs/content/advanced/config/experimental-config.md b/docs/content/advanced/config/experimental-config.md
new file mode 100644
index 00000000..208ac20e
--- /dev/null
+++ b/docs/content/advanced/config/experimental-config.md
@@ -0,0 +1,9 @@
+---
+title: Experimental Configuration
+---
+
+There are several experimental features that can be enabled by setting the appropriate environment variables. These features are not guaranteed to be stable and may change in future releases.
+
+| Env              | Default | Example | Description                            | Notes                                   | More Info                |
+| ---------------- | ------- | ------- | -------------------------------------- | --------------------------------------- | ------------------------ |
+| EXPERIMENTAL_AWG | false   | true    | Enables experimental AmneziaWG support | Planned to be enabled by default in v16 | [See here](./amnezia.md) |