How to install AmneziaWG (Wireguard with obfuscation)?

VecH

Renowned Member
Sep 12, 2015
59
1
73
How to install AmneziaWG (Wireguard with obfuscation)?

When trying to find instructions for Debian 12 (on which Proxmox is based)

I encountered errors, official packages are not installed, dkms errors occur during assembly (apparently due to the mismatch of the names of the kernel packages and sources/headers)

Who managed to install these packages?

I tried to install according to the instructions from github
https://github.com/amnezia-vpn/amneziawg-linux-kernel-module?tab=readme-ov-file#debian

I haven't tried from the sources for manual installation (I'm afraid) and the test server has a very weak processor and very little RAM
 
Put it into a vanilla Debian VM!

Never do such things on the node itself. You are leaving well tested and "known good" territory immediately...
 
  • Like
Reactions: Johannes S
I need it on the host to be able to solve problems with virtual machines

The host itself is in a closed perimeter and there is no way to connect to it (it is closed in educational institutions of the state), it is only possible to connect the host to my home (I do maintenance), and not each virtual machine, but the host itself
 
Then you need a jump VM, or separate jump machine that can reach the management network for your proxmox servers.
 
Then you need a jump VM, or separate jump machine that can reach the management network for your proxmox servers.
I have one server (host) in the network and nothing else (it is a border server)

In general, it is clear that due to the fact that the kernel and source packages are renamed, the AmneziaWG installer cannot compile the kernel module (DKMS)
 
I maintain amneziawg-installer (https://github.com/bivlked/amneziawg-installer) — automates AWG 2.0 setup but Ubuntu only for now (24.04 / 25.10).

Problem is the PPA only builds for Ubuntu kernels. DKMS expects Ubuntu-style header package names and pve-kernel names them differently, so the build just breaks.

Since you need it on the host, try building from source. The amneziawg-linux-kernel-module repo has a build/newer-ubuntu branch that handles some non-standard kernel naming. Not tested on pve-kernel specifically but might work if you have pve-headers installed.

If a full VM is overkill for your setup, Ubuntu 24.04 in LXC works too — my installer runs fine there and LXC is basically no overhead.

Debian support keeps coming up, tracking it here: https://github.com/bivlked/amneziawg-installer/issues/15