Skip to main content

How to Install AmneziaWG-Go

Overview​

This guide shows you how to install AmneziaWG-Go on Ubuntu or Debian Linux.

Installation​

  1. If Git is not installed, install it:

    sudo apt install git
  2. Update the package list and install Go and the build tools:

    sudo apt-get update
    sudo apt install golang-go build-essential
  3. Download the AmneziaWG-Go source code, open the project directory, and build the program. Run these commands in order:

    git clone https://github.com/amnezia-vpn/amneziawg-go
    cd amneziawg-go
    make

    On older distribution releases, the build may fail because the installed Go version is too old. If this happens, install a current version using the official installation instructions for Linux, then run make again from the amneziawg-go directory.

  4. Install the program:

    sudo make install
  5. Verify the installation:

    amneziawg-go --version

    If the command displays version information, AmneziaWG-Go is installed.

  6. Start AmneziaWG-Go and create the wg0 interface:

    sudo amneziawg-go wg0

    The interface needs to be configured separately before it can carry VPN traffic.

    The following warning may appear:

    Running amneziawg-go is not required because this kernel has first class support for AmneziaWG. For information on installing the kernel module please visit: https://github.com/amnezia-vpn/amneziawg-linux-kernel-module

    This message describes the option to use a kernel module. It is displayed without checking whether the AmneziaWG module is installed and does not by itself indicate a startup error.

For further instructions on using AmneziaWG-Go, see the project repository.

Contact the chat for help if something does not work