Download Happ for Linux
- Author
- Dmitry Sokolov, Lead technical writer
- Reviewed by:
- Artem Volkov
- Fact-checked:
- Published:
- Guide version:
- 1.0
In short
Happ for Linux is distributed as deb, rpm and pkg.tar.zst packages for x64 and arm64 in the Happ-proxy/happ-desktop GitHub releases. You need Ubuntu 22.04+, Debian 11.6+ or Red Hat 8.10+ with GCC 10+ and glibc 2.31+.
The desktop Happ for Linux is built on Qt 6 and uses the same Xray-core engine as the Windows and macOS versions. Each architecture has three packages: deb for Debian and Ubuntu, rpm for Red Hat and compatible systems, and pkg.tar.zst for Arch Linux and its derivatives. Packages are published only in GitHub releases, and the latest/download links lead to the stable release, which as of 2026-09-27 is 4.3.0. The current build will not start on older distributions with an old glibc.
Happ for Linux
Happ for Linux is a graphical client on Qt 6 for connecting to your own servers through Xray-core. It comes in three package formats so that it can be installed the native way on the popular distribution families.
All six packages are in the Releases section of the Happ-proxy/happ-desktop repository. Links with latest/download in the name always point to the latest stable release.
The app contains no servers. After installation you will need a key or a subscription, as on the other platforms.
Official download links
- Happ.linux.x64.debGitHub · deb — x64, for Debian, Ubuntu and derivatives
- Happ.linux.x64.rpmGitHub · rpm — x64, for Red Hat and compatible distributions
- Happ.linux.x64.pkg.tar.zstGitHub · pkg.tar.zst — x64, for Arch Linux and pacman-based derivatives
- Happ.linux.arm64.debGitHub · deb — arm64, for Debian and Ubuntu on ARM
- Happ.linux.arm64.rpmGitHub · rpm — arm64, for rpm-based distributions on ARM
- Happ.linux.arm64.pkg.tar.zstGitHub · pkg.tar.zst — arm64, for Arch-like systems on ARM
The latest stable release of the desktop version on GitHub is 4.3.0 from September 15, 2026.
Builds and system requirements
| Build | Technology | Minimum OS version |
|---|---|---|
| Happ for Linux x64 | Qt 6, deb, rpm and pkg.tar.zst packages | Ubuntu 22.04+, Debian 11.6+, Red Hat 8.10+; GCC 10+ and glibc 2.31+ |
| Happ for Linux arm64 | Qt 6, deb, rpm and pkg.tar.zst packages for ARM | Ubuntu 22.04+, Debian 11.6+, Red Hat 8.10+; GCC 10+ and glibc 2.31+ |
Which build to choose
Pick the package format by your package manager: deb for apt, rpm for dnf and yum, pkg.tar.zst for pacman. Pick the architecture from the output of uname -m.
Before downloading, check glibc with the ldd --version command. If the version is below 2.31, the current build will not start, and you have two options: update the distribution or use Legacy 1.0.2.
For work machines, take the stable release. The prerelease, which is 4.4.6 as of 2026-09-27, contains new features, such as separate settings for each subscription, but may be less stable.
How to make sure the file is official
Download the package from the link in the documentation
Open the download table on docs.happ.info or the github.com/Happ-proxy/happ-desktop/releases page and choose the file you need in the Assets list. In a terminal, wget or curl -LO with the same link works.
Result: The file is named Happ.linux.x64 or Happ.linux.arm64 with the extension .deb, .rpm or .pkg.tar.zst.
Look at the package metadata
Run dpkg-deb -I Happ.linux.x64.deb, rpm -qpi Happ.linux.x64.rpm or pacman -Qip Happ.linux.x64.pkg.tar.zst. Check the package name, version and architecture.
Result: The version matches the release number and the architecture matches your system.
Compare the size and the hash
Compare the file size with the one shown on the release page. If a SHA-256 hash is published there, run sha256sum and compare the strings in full.
Result: The size and the hash match the published ones.
How to update Happ
Official Happ packages come out in GitHub releases, so updating is done by hand. Download the new version and install it over the old one with the same command you used for the first installation.
Turn off the tunnel in Happ before updating. That way the package manager can replace the files calmly, and the system is not left with routes from the old process.
A convenient way to follow new versions is the releases page, or the Atom feed at github.com/Happ-proxy/happ-desktop/releases.atom in an RSS reader.
Release 4.3.0 fixed the loss of the tunnel after sleep on Linux. If you noticed a dropped connection after closing a laptop lid, updating to 4.3.0 or newer covers that case.
What Happ can do on Linux
| Feature | Support |
|---|---|
| TUN mode (all device traffic) | Yes |
| System proxy | Yes |
| Proxy for individual apps | No data |
| Sharing the connection over the local network | Yes |
| Routing | Routing profiles |
What next
Key takeaways
- Official Happ packages for Linux come in the deb, rpm and pkg.tar.zst formats.
- Each format is built for two architectures: x64 and arm64.
- You need GCC 10+ and glibc 2.31+, and you can check the glibc version with the ldd --version command.
- The documentation names Ubuntu 22.04+, Debian 11.6+ and Red Hat 8.10+ as supported.
- Official Happ packages for Linux are published only in the developer's GitHub releases.
Frequently asked questions
Which Happ package should I download for my Linux distribution?
Go by your package manager. For Ubuntu, Debian, Linux Mint and other apt systems, take the .deb. For Red Hat, Fedora, Rocky and AlmaLinux with dnf, take the .rpm. For Arch Linux, Manjaro and EndeavourOS with pacman, take the .pkg.tar.zst. The uname -m command shows the architecture: x86_64 means x64 and aarch64 means arm64.
Will Happ run on Ubuntu 20.04?
The documentation names Ubuntu 22.04 as the minimum. Ubuntu 20.04 formally ships glibc 2.31, but that version is not officially supported, and the Qt 6 dependencies may fail to install. It is safer to update the system to 22.04 or newer. For older systems the developer keeps the Legacy 1.0.2 release on GitHub.
How do I install the Happ deb package?
Go to the folder with the file and run sudo apt install ./Happ.linux.x64.deb, or use the arm64 name on ARM. When you give apt a file path, it pulls in the dependencies from your distribution's repositories on its own. Double-clicking the file in the app center also works, but if dependencies fail, the terminal output is easier to read.
Is Happ available as an AppImage, Flatpak or Snap?
The official Linux download table lists only deb, rpm and pkg.tar.zst for x64 and arm64. There are no AppImage, Flatpak or Snap builds among the official links. Such builds from third-party sources are not official, and their contents are hard to check, so it is better not to install them.
How do I check that a downloaded Linux package is official?
Download the file only from the github.com/Happ-proxy/happ-desktop releases page. Then look at the metadata: dpkg-deb -I for deb, rpm -qpi for rpm, pacman -Qip for pkg.tar.zst. Compare the name and size with what the Assets list shows. If a SHA-256 hash is published on the release page, compare it with the output of sha256sum.
Does Happ work on a Raspberry Pi and other ARM computers?
Happ ships arm64 packages for ARM. They suit a 64-bit system on a board if the distribution meets the requirements: Ubuntu 22.04+ or Debian 11.6+ with glibc 2.31+. On a 32-bit system where uname -m shows armv7l, the arm64 packages will not install. A graphical Qt app also needs a desktop environment.
Do I need root to install Happ on Linux?
For installing the package, yes: apt, dnf and pacman require sudo. Running in TUN mode also needs elevated rights, because the app creates a network interface and changes routes. If you see an administrator password prompt when connecting, that is expected behavior and not a sign of tampering.
Topics mentioned
Related articles
Related sections
Sources
- Happ system requirements — accessed September 27, 2026
- Happ documentation: download table — accessed September 27, 2026
- happ-desktop releases on GitHub — accessed September 27, 2026
- Happ Legacy 1.0.2 on GitHub — accessed September 27, 2026
- Adding a configuration and a subscription — accessed September 27, 2026
- Local network connections — accessed September 27, 2026
- Routing in Happ — accessed September 27, 2026
- Ping in Happ — accessed September 27, 2026