To set up HAPP on a Mac or MacBook, install the appropriate version of the app, add your access details, and connect to a server.
HAPP is available through the App Store and as a DMG installation image. The interface and system permission prompts may differ between versions.
If you do not have access details yet, read where to get a key or subscription.
Open the official website, click Download, and choose macOS.
Open the Apple menu in the top-left corner and choose About This Mac.
If separate builds are available, choose ARM64 for Apple Silicon or x64 for Intel. If the build is marked as universal, it is designed for both architectures.
Also check the macOS requirements for the version you choose. Compatibility may differ between the App Store version and a separate desktop build.
Choose one of the installation methods.
App availability depends on the country or region of your Apple account. If the app cannot be downloaded, check whether a DMG version is available on the official website.
After installation, you can eject the image in Finder.
The first time you open HAPP, macOS may ask you to confirm opening an application downloaded from the internet.
If you see a message saying the developer cannot be verified, the app is damaged, or a threat was detected, pay attention to the exact wording: these are different situations. Do not disable macOS security completely.
Apple guide to opening and verifying apps →
Open the message or account dashboard of the service that provided access.
Copy the connection details in full. If there is a dedicated copy button, use it. To copy selected text on a Mac, you can also press Command + C.
You need the actual connection details. A regular link to the service website or payment page will not work.
A ready-made key already contains the connection parameters. You do not need to manually enter the server address, port, or other values.
If your access provider offers this button, click it on your Mac.
The browser may ask for permission to open the app. Confirm the action and complete the import in HAPP.
If the button does not work, copy the original link and import it from the clipboard instead.
After importing a key, an individual connection should appear. When you add a subscription link, HAPP downloads its contents.
If the server group is collapsed, expand it.
If the subscription appears but the list is empty, refresh it. If an error occurs, check your internet connection and save the error message.
The subscription name, number of servers, and additional details are set by your access provider.
Select the server you want from the list and click the main connection button.
If your access provider recommended a specific server or connection mode, follow those instructions.
The first time you connect, macOS may ask for permission to add a VPN configuration or install a helper component. The exact prompts depend on the HAPP version and connection mode.
Confirm the request that appears after your action in the app. If macOS asks for an administrator password or Touch ID, use the system confirmation window.
On an organization-managed Mac, the required permissions may depend on administrator settings.
These modes route traffic into the app in different ways.
| Mode | What to know |
|---|---|
| System proxy | Used by applications that follow the macOS system proxy settings |
| TUN | Processes traffic through a virtual network interface; the final traffic path depends on routing rules |
Not all applications use the system proxy. At the same time, TUN does not necessarily mean that every connection will go through the same server: exclusions may still apply.
For your first connection, start with the app’s default settings or your provider’s recommendations. Change the mode only for a specific reason and check the result after each change.
Wait until HAPP shows that the connection is active.
Then:
If the applications you need work correctly, the basic setup is complete.
The connection status alone does not confirm successful data transfer. A working browser also does not guarantee that every other application is using the same route.
Use the disconnect button in HAPP and wait for the connection status to change.
Closing the window with the red button on a Mac does not necessarily quit the app and does not confirm that the connection has been disconnected.
You do not need to remove the subscription or servers — they will remain available for the next connection.
If the problem affects only one server, tell your access provider its name.
Use the refresh command next to the subscription or in its menu.
HAPP will download the latest server list and settings. This action does not extend your access period or make a payment.
If you use an individual key, ask the person or service that provided it whether it is still valid.
Check your Mac architecture and the macOS version required by the build.
If the app is being opened directly from a mounted DMG, complete the installation and launch it from the Applications folder instead.
If macOS shows a system warning, save the exact message and check where the app was downloaded from.
Make sure the internet works when HAPP is disconnected. Copy the link again, check that it is still valid, and repeat the import or refresh.
Do not add the same subscription repeatedly, as this may only create duplicates.
Check whether all requested permissions were granted. Pay attention to any error messages related to the VPN configuration or helper component.
If another VPN application is running at the same time, disconnect it for testing.
Check the connection mode and the application’s own network settings. It may not use the system proxy or may have a separate configuration.
Open HAPP again and disconnect using the normal disconnect button.
If the error remains, check the proxy settings for the active Wi-Fi or Ethernet connection in macOS network settings. A local proxy setting may still be enabled even though the proxy is no longer running.
Only change settings whose purpose you understand. On a work Mac, proxy settings may be required for your organization’s network.
Detailed troubleshooting: HAPP is not working →