add support for AzireVPN

[jkaberg]

Description

added support for AzireVPN, including support for port forwarding. Support for OpenVPN was not added, more information here

documentation/wiki PR also submitted at qdm12/gluetun-wiki#186

Changes to servers.json are generated with go run main.go update -maintainer -providers azirevpn

Issue

#497

Assertions

• I am aware that we do not accept manual changes to the servers.json file
• I am aware that any changes to settings should be reflected in the wiki

[jkaberg]

@qdm12 would be great to get some feedback on this one!

[dwolstenholme13]

Hi @jkaberg I've tried out this PR on my setup, and while it seems to set up a VPN correctly, the port forwarding doesn't seem to be working for me:

gluetun  | 2026-05-31T16:30:08+09:00 INFO [wireguard] Wireguard setup is complete. Note Wireguard is a silent protocol and it may or may not work, without giving any error message. Typically i/o timeout errors indicate the Wireguard connection is not working.
gluetun  | 2026-05-31T16:30:08+09:00 INFO [MTU discovery] finding maximum MTU, this can take up to 6 seconds
gluetun  | 2026-05-31T16:30:12+09:00 INFO [MTU discovery] setting VPN interface tun0 MTU to maximum valid MTU 1435
gluetun  | 2026-05-31T16:30:13+09:00 INFO [dns] DNS server listening on [::]:53
gluetun  | 2026-05-31T16:30:14+09:00 INFO [dns] ready and using DNS server with dot upstream resolvers
gluetun  | 2026-05-31T16:30:14+09:00 INFO [dns] downloading hostnames and IP block lists
gluetun  | 2026-05-31T16:30:49+09:00 WARN [dns] downloading block lists failed, skipping: scanning: context deadline exceeded (Client.Timeout or context cancellation while reading body), scanning: context deadline exceeded (Client.Timeout or context cancellation while reading body)
gluetun  | 2026-05-31T16:30:54+09:00 INFO [ip getter] Public IP address is <public IP address> (<country/city I selected with SERVER_COUNTRIES> - source: ipinfo+ifconfig.co+ip2location+cloudflare)
gluetun  | 2026-05-31T16:31:00+09:00 INFO [vpn] There is a new release v3.41.1 (v3.41.1) created 108 days ago
gluetun  | 2026-05-31T16:31:00+09:00 INFO [port forwarding] starting
gluetun  | 2026-05-31T16:31:01+09:00 ERROR [vpn] starting port forwarding service: port forwarding for the first time: listing port forwardings: HTTP status code not OK: 500 500 Internal Server Error: {
gluetun  |     "status": "error",
gluetun  |     "message": "Internal error",
gluetun  |     "data": {
gluetun  |         "source_ip": "<public IP, same as in "Pubilc IP address" message above>",
gluetun  |         "internal_ipv4": "<my assigned IP, same as that in .conf files from AzireVPN>"
gluetun  |     }
gluetun  | }

To confirm I'm setting this up correctly, I went to the "VPN" tab in my AzireVPN account, and clicked on "Configuration File" to generate a new configuration file, which was the name of an animal. Inside this was a lot of .conf files, all with the same PrivateKey and Address lines. I copied the PrivateKey value to the WIREGUARD_PRIVATE_KEY env variable, and the IPv4 part ("x.y.z.a/32") to WIREGUARD_ADDRESSES in my docker-compose.yml file. VPN_SERVICE_PROVIDER is set to "azirevpn", and VPN_TYPE to "wireguard". I set SERVER_COUNTRIES to the name of the country I want my traffic to go through, VPN_PORT_FORWARDING to "on", and then I set AZIREVPN_TOKEN to the value which appeared in AzireVPN's Settings->Tokens page after I downloaded that config file.

Am I doing something wrong? Thanks!

[jkaberg]

Not entirely sure why it wouldnt work, here's an snippet of my docker compose environment:

....
      - VPN_SERVICE_PROVIDER=azirevpn
      - VPN_TYPE=wireguard
      - SERVER_COUNTRIES=Sweden
      - WIREGUARD_PRIVATE_KEY=<private key>
      - WIREGUARD_ADDRESSES=<redacted - but cidr like 10.0.123.123/32>
      - AZIREVPN_TOKEN=<redacted>
      - VPN_PORT_FORWARDING=on
....

Ran a test with above just now and Gluetun logs:

vpn-1  | 2026-05-31T22:18:53+02:00 INFO [dns] downloading hostnames and IP block lists
vpn-1  | 2026-05-31T22:18:53+02:00 INFO [ip getter] Public IP address is 123.123.123.123 (Sweden, Västra Götaland, Göteborg - source: ipinfo+ifconfig.co+ip2location+cloudflare)
vpn-1  | 2026-05-31T22:18:53+02:00 INFO [vpn] There is a new release v3.41.1 (v3.41.1) created 109 days ago
vpn-1  | 2026-05-31T22:18:53+02:00 INFO [port forwarding] starting
vpn-1  | 2026-05-31T22:18:54+02:00 INFO [port forwarding] fetching existing port forwards, got []
vpn-1  | 2026-05-31T22:18:54+02:00 INFO [port forwarding] port forwarded is 12345
vpn-1  | 2026-05-31T22:18:54+02:00 INFO [firewall] setting allowed input port 12345 through interface tun0...
vpn-1  | 2026-05-31T22:18:54+02:00 INFO [port forwarding] writing port file /tmp/gluetun/forwarded_port

[dwolstenholme13]

Not entirely sure why it wouldnt work, here's an snippet of my docker compose environment:

Yeah, here's mine:

   environment:
      - TZ=<my TZ>
      - VPN_SERVICE_PROVIDER=azirevpn
      - VPN_TYPE=wireguard
      - WIREGUARD_ADDRESSES=10.0.<x.y>/32
      - WIREGUARD_PRIVATE_KEY="<my private key>"
      - SERVER_COUNTRIES=Sweden
      - VPN_PORT_FORWARDING=on
      - AZIREVPN_TOKEN="<my token>"

Then I get this in the start-up log:

gluetun  | 2026-06-07T18:37:41+09:00 INFO Settings summary:
gluetun  | ├── VPN settings:
gluetun  | |   ├── VPN provider settings:
gluetun  | |   |   ├── Name: azirevpn
gluetun  | |   |   ├── AzireVPN token: 4c8...d07
gluetun  | |   |   ├── Server selection settings:
gluetun  | |   |   |   ├── VPN type: wireguard
gluetun  | |   |   |   ├── Countries: sweden
gluetun  | |   |   |   └── Wireguard selection settings:
gluetun  | |   |   └── Automatic port forwarding settings:
gluetun  | |   |       ├── Redirection listening port: disabled
gluetun  | |   |       ├── Use port forwarding code for current provider
gluetun  | |   |       └── Forwarded port file path: /tmp/gluetun/forwarded_port
...
gluetun  | 2026-06-07T18:38:43+09:00 INFO [port forwarding] starting
gluetun  | 2026-06-07T18:38:44+09:00 ERROR [vpn] starting port forwarding service: port forwarding for the first time: listing port forwardings: HTTP status code not OK: 500 500 Internal Server Error: {
gluetun  |     "status": "error",
gluetun  |     "message": "Internal error",
gluetun  |     "data": {
gluetun  |         "source_ip": "<public IP address>",
gluetun  |         "internal_ipv4": "<WIREGUARD_ADDRESSES address>"
gluetun  |     }
gluetun  | }

But I've also found something odd: if I change the setting for "VPN_PORT_FORWARDING" to "off" and restart, I get this:

gluetun  | 2026-06-07T18:48:47+09:00 INFO [port forwarding] starting
gluetun  | 2026-06-07T18:48:57+09:00 ERROR [vpn] starting port forwarding service: port forwarding for the first time: listing port forwardings: doing request: Get "https://api.azirevpn.com/v3/portforwardings?internal_ipv4=<WIREGUARD_ADDRESSES address>": context deadline exceeded