amnezia-vpn/amnezia-client

Amnezia is a cross-platform VPN client aimed at people who want their own VPN endpoint instead of a shared commercial one. Its distinctive step is server setup: you give the client an IP address and SSH credentials, and it installs VPN containers on your machine, then connects. The README frames this as the project's key feature Amnezia VPN README.

What the client does

After the server is provisioned, the client handles the connection. It supports OpenVPN, WireGuard and IKEv2, plus variants intended to obscure traffic: OpenVPN over Cloak, OpenVPN over Shadowsocks, AmneziaWG and XRay README features. A split-tunneling option lets you route only selected sites through the VPN, or selected apps on Android and desktop README features.

The client ships for Windows, macOS, Linux, Android and iOS README features; installers are available from the project site and its mirror download page and GitHub releases releases. If the project website is blocked where you are, the README offers an alternative mirror link.

Setup requirements and limits

Self-hosting depends on what you already have: a server you can reach over SSH, and the IP address and login credentials to enter in the client. The README describes the automated container installation but does not detail which operating systems support it, nor what happens to an existing server configuration — check the official docs and troubleshooting pages before pointing it at a machine that already serves other purposes docs.

Split tunneling by app is listed only for Android and desktop, not iOS README features. The project also mentions configuring the AmneziaWG protocol on Keenetic beta firmware Keenetic note; that is a router-side configuration, separate from using the client itself.

Running a VPN server makes you responsible for its uptime, credentials and traffic. The README does not state how the client stores credentials or what data the server operator can see.

Building from source and licence

The repository is C++ with a Qt-based interface. Building requires CMake, a platform toolchain, Qt 6.10+ with the Core, Qt 5 Compatibility and Remote Objects modules, and the Conan package manager, plus Android SDK/Ninja for Android builds; installer packaging additionally uses the Qt Installer Framework or WiX build requirements. The source uses git submodules, so a recursive submodule pull is required after checkout README.

The license is GPL-3.0, with third-party components under their own terms README. Any distribution of a modified build must follow GPL conditions.

HotRepo's take

The project has strong visible interest — 15,611 stars as observed on 2026-10-30 — but the supplied board sample is too sparse to say whether that interest is growing or fading repository. Stars say nothing about the security of the VPN stack; treat the self-hosting setup as an operational responsibility.