Setting Up Happ: From First Launch to Routing
- Author
- Ekaterina Lebedeva, Knowledge Base editor
- Reviewed by:
- Artem Volkov
- Fact-checked:
- Published:
- , updated
- Guide version:
- 1.0
In short
To set up Happ, import a server key or subscription with the “+” button, choose TUN mode for all device traffic or system proxy for individual programs, and connect to a server. After that come platform-specific interface details and, if needed, traffic routing rules.
Happ setup is the same in spirit on every platform: get a server key or subscription link, add it to the app through the clipboard, a QR code or a deep link, pick a server and connect. Then you choose a connection mode. TUN sends all of the device's traffic through Happ, while the system proxy covers only programs that read the system settings. Each of the seven platforms has its own page with the exact path through the interface and the system permissions you confirm on the first connection. Once the basic connection works, some users go further and decide which sites and apps go through the proxy, and which go direct or are excluded from the tunnel. That step is traffic routing.
Setup by platform
- Happ setup on WindowsSetting up Happ on a PC comes down to three actions: copy a key or subscription link, click “+” and import it from the clipboard, then pick a server and connect.
- Happ setup on macOSTo set up Happ on macOS, copy a key or subscription link, click “+” and import it from the clipboard, pick a server and connect.
- Happ setup on LinuxTo set up Happ on Linux, import a key or subscription with the “+” button from the clipboard, pick a server and connect in TUN mode if you need all system traffic.
- Happ setup on AndroidTo set up Happ on Android, copy a key or subscription link, tap “+” at the top right and paste it from the clipboard or scan a QR code.
- Set up Happ on iPhoneTo set up Happ on iPhone, copy a key or subscription link, tap the plus button at the top right and paste it from the clipboard or scan a QR code.
What the Setup Section Covers
The Setup section is about the path from a freshly installed app to a working connection. It is not about choosing a file to download, and it is not about rules for particular sites. For downloads, go to the Download section. Fine traffic rules belong to the routing section.
Here you get one logic for all platforms and seven pages with the details of a specific system: Windows, Android, iPhone and iPad and four more platforms with the same structure. Each page says what to confirm in the system, where to find the menu item you need and how the platform differs from the others.
How Setup Works: From Key to Connection
The task takes three steps, whatever the platform. First you need access to a server, your own or through a provider. The section on access keys explains how to get one. Then you add the key or the subscription address to the app. The import method is the same on every system, and the Import section has the details. Finally, you pick a server from the list and connect.
On the first connection the system usually asks for a permission: to create a network interface on a computer, or to add a VPN configuration on a phone. This is a normal part of setup, not a sign of a problem, and it applies to both TUN mode and the system proxy.
TUN or System Proxy: Which to Choose
Choosing a mode is not a technical detail but a question of your goal. TUN creates a virtual network interface in the system and receives the traffic of all programs on the device. The system proxy covers only what reads the system proxy settings, for example a browser. On Windows, macOS and Linux the two are mutually exclusive options of one connection. On phones and TVs the system proxy is not always available, and TUN becomes the main way to connect.
A detailed comparison of the modes for practical cases is a separate page comparing TUN and the system proxy.
Where to Go Next
| Task | Section |
|---|---|
| Set up a specific platform step by step | /setup/windows, /setup/android, /setup/ios and others |
| Set rules for individual sites and apps | The routing section |
| Something does not work after setup | The troubleshooting section, or errors |
Happ setup is a one-time action for one device. If you have several servers or subscriptions, you add and configure each one the same way, separately, rather than with one shared switch for the whole app.
Key takeaways
- Happ setup on any platform consists of the same steps: get a key or subscription, import it, then choose a server and a connection mode.
- You can import a key or subscription into Happ in three equal ways, through the clipboard, a QR code or a deep link, whatever the platform.
- TUN sends all of the device's traffic through Happ, while the system proxy covers only programs that read the system proxy settings. On a computer the two are mutually exclusive options of one connection.
- Each of the seven Happ platforms has its own setup page with system permissions and interface details. The Setup section links to them instead of repeating them.
- Fine-tuning traffic after the first connection, meaning direct, proxy and block rules, DNS, and GeoIP and GeoSite categories, lives in a separate routing section.
Frequently asked questions
Where does Happ setup start if I have no key or subscription yet?
You first need access to a server: either your own server with a protocol such as VLESS or Shadowsocks, or a subscription from a third-party provider. Happ itself provides no servers and does not sell subscriptions. That is a separate task, covered in the material on access keys. Setting up the app starts only after you have a server address or a subscription link.
How does a server key differ from a subscription during first-time Happ setup?
A key is a link to one specific server of one protocol, for example vless:// or ss://. A subscription is an address behind which the provider keeps a whole list of servers, the traffic balance and the expiry date up to date. Both are imported into Happ the same way, through the clipboard, a QR code or a deep link. The difference shows later, in what gets updated and how.
Do I have to use TUN mode, or is the system proxy enough?
It depends on your goal, not on which mode is considered the main one. The system proxy is enough if only a browser and a few programs that read system settings should go through Happ. If all of the device's traffic, including games and background apps, must go through the server, you need TUN. On phones and TVs it is usually the main way to connect.
After the first connection, how do I exclude particular sites or programs from the tunnel?
That is no longer connection setup but traffic routing. Lists of domains and IP addresses that go direct, go through the proxy or get blocked are defined in the routing profile of a subscription. The rules apply on the next connection to a server, not instantly. A detailed look at the profile structure and ways to build one belongs to the routing section.
Is Happ setup very different on a phone and on a computer?
The overall logic is the same: import, pick a server, connect. The interface details and system permissions differ, though. On a computer, TUN and system proxy are a mutually exclusive choice in the connection settings, while on a phone the system separately asks for permission to create a VPN connection the first time you connect. The platform pages describe these differences step by step for each system.
Do I need to set up Happ again after every app update?
No. Updating the file or the store version does not reset the servers, subscriptions and routing profiles you added. You only have to set up the connection again in special cases, for example after reinstalling the operating system, or after removing the app completely and installing it from scratch.
Happ will not connect after setup or shows an error right away. Where should I look next?
First check the platform setup page: it covers the system permissions and typical errors for your particular system. If the error message is exact, look it up in the section on Happ errors. If it simply does not work and there is no specific text, use the troubleshooting section, which leads from a symptom to its likely cause.
Related sections
Sources
- Happ documentation: adding a configuration and subscription — accessed September 28, 2026
- Happ documentation — accessed September 28, 2026
- Happ documentation: routing — accessed September 28, 2026