To connect through HAPP on a Windows computer, you need to install the app, add a key or subscription link, choose a server, and turn on the connection.
Below is the full setup process, along with an explanation of TUN mode and the system proxy. The names and locations of interface elements may differ between HAPP versions.
If you do not have access details yet, read where to get a key or subscription.
For most computers with Intel or AMD processors, use the x64 build. For Windows on ARM computers, use ARM64.
You can check your system architecture in Windows Settings: open System → About and find System type.
On the official website, open the download section and choose Windows. The link to our mirror downloads the x64 installer directly.
If the installation ends with an error, save the exact message. It is especially useful to note whether the error refers to the HAPP application itself or to its service.
Open the message or account dashboard of the service that provided access.
Copy the connection details in full. It is best to use a copy button if one is available.
If the link is on your phone, open the account dashboard on your computer or send the link to yourself through a private communication channel. Do not post it in public chats: it may contain personal access details.
For a ready-made key or subscription link, you do not need to manually enter the server address, port, or protocol parameters.
If your provider has an Add to HAPP button, you can use it instead. Confirm that the browser is allowed to open HAPP, then complete the import in the app.
If the button does not work, copy the link and import it from the clipboard.
After adding a key, an individual connection should appear. After importing a subscription, the app downloads the list of available servers.
If the group is collapsed, expand it.
If the subscription appears but there are no servers, refresh it. If an error appears, check your internet connection and save the error message.
Server names, the number of servers, and any additional details depend on your access provider.
On Windows, it is important not only to connect HAPP to a server, but also to route the required traffic through the app.
For this, HAPP uses system proxy and TUN modes.
| Mode | How it works |
|---|---|
| System proxy | Sets a proxy address in Windows. Applications that use the system proxy settings will send traffic through it |
| TUN | Uses a virtual network interface to process traffic routed to it by the operating system |
This mode works with applications that support the Windows system proxy settings.
Some applications use their own connection settings or connect directly. This means that a working browser does not necessarily mean that every program on the computer is using the same route.
TUN can handle traffic from applications that do not have their own proxy settings. The final route still depends on routing rules and exclusions.
This mode may require elevated permissions and a correctly installed HAPP service.
If your access provider has given you instructions for a specific mode, follow them.
Otherwise, start with the mode selected by HAPP after installation and test the applications you need. If you are using the system proxy and some programs ignore it, the next step may be to test TUN mode.
Disconnect before switching modes and check the result after each change.
Select the server you want from the list, then turn on the connection using the main HAPP button.
If the app requests additional permissions for the selected mode, follow the prompts.
Wait until the connection status changes. If an error appears, note whether it refers to the server, the HAPP service, or creation of the network interface.
The connection status alone does not confirm that every application is working through HAPP. With the system proxy, some programs may ignore it, while with TUN, routing rules affect the traffic path.
If the applications you need work correctly, the basic setup is complete.
Use the disconnect button inside HAPP. Closing the window should not be treated as confirmation that the connection has stopped, because the app may continue running in the background.
To test another server:
You do not need to remove the subscription when switching servers.
Check that the build matches your computer architecture and that the file finished downloading.
If Windows shows an error or security warning, save the exact message. Do not disable Windows security completely just to install the app.
Copy the link again and repeat the clipboard import.
Make sure it is the actual connection data, not the address of your account dashboard.
Save the error message and error code, if one is shown.
Check whether the installation completed without errors and whether the requested permissions were granted. Simply refreshing the subscription will not fix a problem with the HAPP service installation.
On a work computer, installation and network configuration permissions may be restricted by your administrator.
Check the selected mode. When using the system proxy, an application may ignore the Windows proxy settings.
The application may also have its own proxy settings or connection rules.
Disconnect HAPP and check your regular internet connection. If it works, try another server and check whether your access is still active.
If another VPN application is running at the same time, disconnect it for testing.
First, open HAPP again and disconnect using the normal disconnect button.
If the problem remains, check Network & Internet → Proxy in Windows Settings. A local proxy setting may still be enabled even though the proxy service is no longer running.
Only change the setting that was used by HAPP. If the proxy was configured by your organization or another application, first confirm what it is used for.
Detailed troubleshooting: HAPP is not working →