What Happ is and how it works
- Author
- Ekaterina Lebedeva, Knowledge Base editor
- Reviewed by:
- Artem Volkov
- Fact-checked:
- Published:
- , updated
- Guide version:
- 1.0
In short
Happ is a cross-platform client app for connecting to proxy servers over VLESS, VMess, Trojan, Shadowsocks, SOCKS5 and Hysteria2. It runs on the Xray-core engine, has no servers of its own and does not collect data about the user.
The app is available on Windows, macOS, Linux, iOS, Android, Android TV and Apple TV. The mobile versions and macOS from the App Store are written in native code, Swift for Apple devices and Kotlin for Android, while the Windows, macOS DMG and Linux versions are built on the cross-platform Qt 6. The user adds a server configuration by hand, as a separate link or as a subscription, and Happ passes this data to the Xray-core engine, which sets up the connection and routes traffic by the rules you set. Happ has no servers of its own: you set one up yourself or get one from a provider.
What Happ does
Happ connects a device to a proxy server and passes traffic through it. The app itself does not provide a server: the user gives its address and parameters, and Happ hands them to the Xray-core engine, which sets up the connection.
The supported protocols are VLESS (including with Reality), VMess, Trojan, Shadowsocks, SOCKS5 and Hysteria2. Each of them checks the client and protects the channel in its own way.
Besides connecting, the app can measure server ping, update the list of servers from a subscription, and apply a routing profile: rules for which sites go direct, which go through the proxy, and which are dropped.
Three ways to add a server
You can get a server configuration into Happ in three different ways, and the method decides what you see in the app:
| Method | What you enter | Where the server ends up |
|---|---|---|
| Manual entry | The protocol and server parameters, field by field | The local list of servers |
| Separate link | vless://…, vmess://… and other URI schemes from the clipboard, a QR code or a deep link | The local list of servers |
| Subscription | One address behind which the provider keeps the list of servers updated | A separate subscription block with its own settings |
For an example of a subscription from a provider, see the pricing page, and for adding it, see import.
Platforms and architecture in brief
Happ is not one program but several builds for different systems, and they are written in different ways:
| Device group | Technology |
|---|---|
| iOS, iPadOS, Android, Android TV, macOS from the App Store | Native code: Swift for Apple devices, Kotlin for Android |
| Windows, macOS (DMG), Linux | The cross-platform Qt 6 framework |
| Apple TV | A separate app, “Happ — Proxy Utility for TV”, without classic routing |
This explains both the minimum OS versions and the interface differences between platforms. You can pick your platform on the download page.
What Happ is not
Happ does not sell subscriptions for access to servers, does not manage them and does not store the user's payment details. It is a client app: it can connect, but it does not provide a communication service by itself.
The word “server” in Happ's interface means a connection configuration, not a physical machine owned by the app's developer. Who administers that machine, the user or the subscription provider, does not matter to the app.
The difference between a client and a typical VPN service is not a formality: it affects what you can configure and whom you ask about the speed and availability of a server. For the glossary of terms used here, see the glossary.
Key takeaways
- Happ is a client app on the Xray-core engine, not a separate service with its own servers and plans.
- A server configuration is added to Happ in three ways: by hand, as a separate link or as a subscription.
- The mobile versions, Android TV and macOS from the App Store are written in native code, while Windows, macOS DMG and Linux use Qt 6.
- The app does not collect data about the user: information about servers and subscriptions is stored on the device.
- Ping, update interval and routing profile are configured in Happ separately for each subscription.
Frequently asked questions
Is Happ a VPN, strictly speaking?
Formally no. Happ is a client that connects to proxy servers over VLESS, VMess, Trojan, Shadowsocks, SOCKS5 and Hysteria2 through the Xray-core engine. A tunnel for the whole device appears when Happ runs in TUN mode and sends the device's traffic to the chosen server. Unlike a typical VPN service, Happ does not sell access to servers of its own: you set one up or get one from a provider.
Does Happ collect data about the user?
According to the developer, the app does not collect user data, and information about added servers, subscriptions and settings stays on the device. Some parameters, such as remaining traffic, expiry date and announcements, Happ receives from the subscription server on each update, but that is the subscription provider's data, not the app's. A provider can also enable statistics through Provider ID: then once a day the app reports the device HWID and OS version to it.
Which devices does Happ run on?
The app is released for Windows, macOS, Linux, iOS, iPadOS, Android, Android TV and Apple TV. The mobile versions, the Android TV version and macOS from the App Store are written in native code, Swift for Apple devices and Kotlin for Android. The Windows, macOS DMG and Linux versions are built on cross-platform Qt 6. Apple TV has a separate app, “Happ — Proxy Utility for TV”, with fewer features and no classic routing.
Do I need a separate server to use Happ?
Yes. Happ is only a client: it can connect to a server over several protocols, but it has no servers of its own and does not sell access to them. You set up a server yourself on a rented or personal machine, or get a ready configuration or subscription from a provider. Without a server address, link or subscription the app has nothing to connect to, and the list of servers stays empty.
How is Happ different from the system proxy in the OS settings?
The system proxy in an OS usually supports one protocol and requires you to type the address, port and sometimes a password by hand. Happ accepts protocol-specific parameters, such as UUID, Reality keys and Hysteria2 obfuscation, from a ready link or subscription, brings up the connection through Xray-core, and can run in TUN mode, covering traffic of the whole device and not only the browser. It also keeps several servers and switches between them without editing system settings.
Can I add a server to Happ that is not in a subscription?
Yes. The plus button on the main screen opens manual entry of the protocol, and the app also accepts separate vless://, vmess://, trojan://, ss://, socks://, hysteria2:// and hy2:// links from the clipboard, by QR code or through a deep link. Such a server goes into the local list separately from the subscription's servers and does not disappear when the subscription updates.
Topics mentioned
Related articles
Sources
- Happ documentation — accessed September 28, 2026
- Happ documentation: adding a configuration and a subscription — accessed September 28, 2026
- Happ documentation: system requirements — accessed September 28, 2026
- Happ documentation: Provider ID — accessed September 28, 2026