Skip to main content

Installing AmneziaVPN on Linux

Overview

This guide describes how to install AmneziaVPN 4.8.19.0 on Linux x64.

On any Linux distribution:

  • the user needs administrator rights to install AmneziaVPN;
  • do not disable the IPv6 subsystem. The Connect button in AmneziaVPN stops working if you use sudo sysctl -w net.ipv6.conf.all.disable_ipv6=1;
  • use the latest version of AmneziaVPN.

AmneziaVPN was tested on the distributions listed in this guide. On these systems, the app starts either right after installation or after you install the packages from the matching section.

On other distribution versions, including versions that are no longer supported, AmneziaVPN may not work as expected.


How to install the app

Download the .linux_x64.tar archive from the latest stable AmneziaVPN release on GitHub, extract it, and run AmneziaVPN_Linux_Installer.bin.

You can extract the archive in a file manager or in the terminal. If the installer or the app does not start, install the packages for your distribution from the section below. Then run the installer or the app again.

If AmneziaVPN is already installed but the app does not open, run the command for your distribution and start the app again.


Supported distributions

The current version of AmneziaVPN is temporarily unavailable for Debian 12 and Ubuntu 22.04.x.

Fedora 41, 42, 43, 44 (x64)

AmneziaVPN installs and starts on a base system without extra packages.

Fedora 41 and Fedora 42 are no longer supported by Fedora Project, but the current version of AmneziaVPN works on them.

After installation, we recommend restarting your device.


Debian 13 (x64)

Install the packages needed for the XCB plugin and system libraries:

sudo apt install libxcb-cursor0 libxcb-xinerama0 libxcb-icccm4 libxcb-keysyms1 libopengl0 libxkbcommon-x11-0

After installing the packages, run the installer.


Ubuntu 24.04.x and Ubuntu 26.04.x (x64)

Install the packages needed for the XCB plugin and system libraries:

sudo apt install libxcb-cursor0 libxcb-xinerama0 libxcb-icccm4 libxcb-keysyms1 libopengl0 libxkbcommon-x11-0

After installing the packages, run the installer.

On Ubuntu 26.04.x, if Docker, Tailscale, or other virtual network interfaces are installed, AmneziaVPN 4.8.19.0 may not detect the main network gateway.

Because of this, the app may fail to get the configuration and disconnect.

Before connecting, add a route to the VPN server IP address manually:

sudo ip route add <vpn_server_ip>/32 via <gateway_ip> dev <interface>

For Self-hosted, use the IP address of your VPS.

You can check the gateway and interface with the ip route command.


Arch Linux (x64)

On Arch Linux, the list of needed packages can depend on the desktop environment and installed system libraries. This example shows how to install AmneziaVPN on Arch Linux with GNOME, where the xcb-util-cursor package may be needed.

  1. Extract the archive:

    tar -xvf ./AmneziaVPN_4.8.19.0_linux_x64.tar
  2. Run the installer:

    ./AmneziaVPN_Linux_Installer.bin

If the installer reports missing components, install them manually and run the installer again.

  1. After installation, start AmneziaVPN from the terminal to check that the app starts and to see possible errors about missing components:

    AmneziaVPN
  2. In our example, the error said that xcb-cursor0 or libxcb-cursor0 was needed to start the Qt XCB plugin. In this case, install xcb-util-cursor:

    sudo pacman -Syu xcb-util-cursor
  3. Start the app again:

    AmneziaVPN

If the app starts from the terminal, close it with Ctrl+C. After that, you can start AmneziaVPN from the app launcher.


openSUSE Leap 16.0, openSUSE Tumbleweed (x64)

AmneziaVPN was tested in the following environments:

  • openSUSE Leap 16.0 with KDE Plasma 6.4.2;
  • openSUSE Tumbleweed 20260331 with KDE Plasma 6.6.3.

To start AmneziaVPN, you may need the libgthread-2_0-0 package.

Install the package with this command:

sudo zypper install libgthread-2_0-0

After installing the package, start the app.

Contact the chat for help if something does not work