To use HAPP on an iPhone or iPad, install the app, add your access details, and allow it to create a VPN connection.
This guide applies to both iOS and iPadOS. The location of interface elements and the wording of system prompts may differ depending on the app and system version.
If you do not have access details yet, start with the HAPP keys and subscriptions page.
If the app is already installed, continue to the next step.
Open the HAPP page in the App Store. Check the developer name: Flyfrog LLC.
Install the app and open it.
App availability depends on the country or region of your App Store account.
If HAPP is not available for your current account, you will need to use an account set to a region where the app is available, or change the region of your existing account.
Opening a link to the US App Store does not automatically change your account region. Changing the language or region of the device itself does not change the App Store country either.
Before changing your account region, review Apple’s requirements. Remaining account balance, some active subscriptions, and Family Sharing may prevent you from changing the country or region.
Apple guide: change your account country or region →
Open the message or account dashboard of the service that provided access.
Copy the key or subscription link in full. If there is a copy button next to it, use that.
You need the actual connection details. A regular link to the service website or payment page will not work.
You do not need to manually enter the server address, port, or other parameters when importing a ready-made key.
Open the QR code scanner in HAPP and allow camera access if requested.
Point the camera at the QR code containing the connection details and complete the import.
It is easiest to scan a code displayed on another screen. If the data is on the same iPhone, copying the original link and importing it from the clipboard is usually more convenient.
Tap it on the device where HAPP is installed. Confirm that the browser may open HAPP if prompted, then complete the import in the app.
If the link does not work from an in-app browser inside a messenger, try opening the page in Safari or copy the link manually instead.
When you add 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, use the refresh command for that subscription. Wait for the result and note any error message that appears.
The subscription name, number of servers, and additional details depend on your access provider.
Tap the server you want to use, then tap the main connection button.
If your access provider recommended a specific server, start with that one.
The first time you connect, iOS may display a system prompt asking to add a VPN configuration. Allow it and confirm the action using the method requested by your device.
This gives HAPP permission to manage its VPN connection. You do not need to enter the server settings separately in the iPhone settings.
Return to HAPP if the system opens another screen, and wait until the connection becomes active.
If your HAPP version includes a current connection check, run it.
Then open several pages in your browser and check the app you plan to use.
The VPN icon by itself does not confirm that the server is successfully transferring data. Check both the connection status and how websites and apps actually work.
Some connections may go directly according to routing rules. This means that a website opening successfully does not prove that all device traffic is going through the selected server.
Open HAPP and tap the disconnect button. Wait until the connection status changes.
Your subscription and servers will remain in the app. You do not need to remove them to disconnect.
If one server does not work but another one does, tell your access provider which server is having the problem.
Use the refresh command next to the subscription or in its menu.
HAPP will download the latest settings and connection list. Refreshing a subscription does not pay for or extend access to the servers.
An individual key does not require this type of list refresh. If a key stops working, request updated connection details from your provider.
Copy the key or link again and immediately import it into HAPP. If iOS asks for permission to paste, allow it.
Make sure you copied the connection details in full, without any surrounding explanatory text.
Check your internet connection with HAPP disconnected. Confirm that the link is still valid and intended for a compatible application.
If possible, try loading it again using a different network.
Check whether you allowed the VPN configuration to be added, and save the exact error message.
If another VPN app automatically enables its own connection, temporarily disconnect it before testing HAPP again.
On an organization-managed device, the ability to add VPN configurations may be restricted by the administrator.
Disconnect HAPP and check the same websites again. If your regular internet connection works, try another server and check whether your subscription access is still active.
Do not start by deleting the app. First make sure you have saved the connection details needed to import it again.
Detailed troubleshooting: HAPP is not working →