From 626eece2f83a34633ff56109390db3825ae3dd4d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Joel=20K=C3=A5berg?= <joel@kaberg.me>
Date: Wed, 11 Mar 2026 10:43:28 +0000
Subject: [PATCH] add support for AzireVPN

---
 setup/advanced/vpn-port-forwarding.md |  1 +
 setup/options/port-forwarding.md      |  2 +-
 setup/providers/azirevpn.md           | 62 +++++++++++++++++++++++++++
 3 files changed, 64 insertions(+), 1 deletion(-)
 create mode 100644 setup/providers/azirevpn.md

diff --git a/setup/advanced/vpn-port-forwarding.md b/setup/advanced/vpn-port-forwarding.md
index dc6cdd2..2753d28 100644
--- a/setup/advanced/vpn-port-forwarding.md
+++ b/setup/advanced/vpn-port-forwarding.md
@@ -8,6 +8,7 @@
 
 VPN server side port forwarding is implemented natively into Gluetun for the following providers:
 
+- **AzireVPN** (WireGuard only, requires active tunnel), [more information](../providers/azirevpn.md)
 - **Private Internet Access**, [more information](../providers/private-internet-access.md)
 - **ProtonVPN**, [more information](../providers/protonvpn.md)
 - **Perfect Privacy**, [more information](../providers/perfect-privacy.md)
diff --git a/setup/options/port-forwarding.md b/setup/options/port-forwarding.md
index 0494382..a30bb85 100644
--- a/setup/options/port-forwarding.md
+++ b/setup/options/port-forwarding.md
@@ -9,7 +9,7 @@ Read [the guide](../advanced/vpn-port-forwarding.md) for details.
 | Variable | Default | Choices | Description |
 | --- | --- | --- | --- |
 | `VPN_PORT_FORWARDING` | `off` | `off` or `on` | Enable custom port forwarding code for supported providers |
-| `VPN_PORT_FORWARDING_PROVIDER` | Current provider in use | `private internet access`, `perfect privacy`, `privatevpn`, `protonvpn` | Choose the custom port forwarding code to use. This is useful when using the custom provider with Wireguard. For PIA, make sure you set `SERVER_NAMES=<server-name>`. |
+| `VPN_PORT_FORWARDING_PROVIDER` | Current provider in use | `azirevpn`, `private internet access`, `perfect privacy`, `privatevpn`, `protonvpn` | Choose the custom port forwarding code to use. This is useful when using the custom provider with Wireguard. For PIA, make sure you set `SERVER_NAMES=<server-name>`. |
 | `VPN_PORT_FORWARDING_STATUS_FILE` | `/tmp/gluetun/forwarded_port` | Valid filepath | File path to use for writing the forwarded port obtained. |
 | `VPN_PORT_FORWARDING_LISTENING_PORT` | | Valid port number | Port redirection to redirect incoming traffic to. Do not use with torrent clients. |
 | `VPN_PORT_FORWARDING_UP_COMMAND` | | Shell command | Command to run when port forwarding has finished setting up. |
diff --git a/setup/providers/azirevpn.md b/setup/providers/azirevpn.md
new file mode 100644
index 0000000..5411866
--- /dev/null
+++ b/setup/providers/azirevpn.md
@@ -0,0 +1,62 @@
+# AzireVPN
+
+## TLDR
+
+```sh
+# Wireguard
+docker run -it --rm --cap-add=NET_ADMIN --device /dev/net/tun \
+-e VPN_SERVICE_PROVIDER=azirevpn \
+-e VPN_TYPE=wireguard \
+-e WIREGUARD_PRIVATE_KEY=wOEI9rqqbDwnN8/Bpp22sVz48T71vJ4fYmFWujulwUU= \
+-e AZIREVPN_TOKEN=your_api_token \
+-e SERVER_COUNTRIES=Sweden qmcgaw/gluetun
+```
+
+```yml
+version: "3"
+services:
+  gluetun:
+    image: qmcgaw/gluetun
+    cap_add:
+      - NET_ADMIN
+    devices:
+      - /dev/net/tun:/dev/net/tun
+    environment:
+      - VPN_SERVICE_PROVIDER=azirevpn
+      - VPN_TYPE=wireguard
+      - WIREGUARD_PRIVATE_KEY=wOEI9rqqbDwnN8/Bpp22sVz48T71vJ4fYmFWujulwUU=
+      - AZIREVPN_TOKEN=your_api_token
+      - SERVER_COUNTRIES=Sweden
+```
+
+## Required environment variables
+
+- `VPN_SERVICE_PROVIDER=azirevpn`
+- `VPN_TYPE=wireguard`
+- `WIREGUARD_PRIVATE_KEY` is your 32-byte key in base64 format
+- `WIREGUARD_ADDRESSES` is your WireGuard interface address(es) in CIDR format
+
+## Optional environment variables
+
+- `SERVER_COUNTRIES`: Comma separated list of countries
+- `SERVER_CITIES`: Comma separated list of cities
+- `SERVER_HOSTNAMES`: Comma separated list of server hostnames
+- `SERVER_NAMES`: Comma separated list of server names
+- `PORT_FORWARD_ONLY`: Filter to servers supporting port forwarding
+- `OWNED_ONLY`: Filter to owned servers only
+- `VPN_PORT_FORWARDING`: defaults to `off` and can be set to `on`
+- `AZIREVPN_TOKEN`: required only if `VPN_PORT_FORWARDING=on`
+
+## VPN server port forwarding
+
+Requirements:
+
+- `VPN_PORT_FORWARDING=on`
+- Active VPN tunnel connection (AzireVPN requires this for port forwarding API endpoints)
+
+AzireVPN will assign and maintain a forwarded port through their API integration in Gluetun.
+See [vpn port forwarding options](../advanced/vpn-port-forwarding.md) for ways to access and use the forwarded port.
+
+## Servers
+
+To see a list of servers available, [list the VPN servers with Gluetun](../servers.md#list-of-vpn-servers).