To connect HAPP to a server, add a key or subscription link to the app. The easiest way is to copy the connection details and import them from the clipboard.
If you do not have connection details yet, first read where to get a key or subscription.
Make sure HAPP is installed and your device is connected to the internet.
Prepare the key or subscription link you received from your access provider or administrator. You need to copy the actual connection details — a regular link to the provider’s website or account dashboard will not work.
Use this method if you can copy the key or link on the same device where HAPP is installed.
Open the message or account dashboard where your connection details are shown.
Tap Copy if that button is available. If you copy the data manually, select the entire key or link without any surrounding explanatory text.
Go to the main screen of the app and tap +.
From the menu, choose the option to import from the clipboard. The exact wording may vary slightly depending on the HAPP version and interface language.
If your system asks for permission to paste the copied data, allow it.
After importing an individual key, the corresponding connection should appear.
When you add a subscription link, HAPP also needs to download its contents. Wait for the process to finish. If the subscription appears but there are no servers inside it, refresh the subscription.
Server names and the number of available servers are determined by your access provider. Having just one server in the list is also normal.
Refreshing a subscription downloads the latest server list and connection settings.
Find the subscription you added and use the refresh button or the corresponding option in its menu. The location of this command depends on the HAPP version.
Wait for the operation to finish. If an error message appears, note its text.
Refreshing applies to a subscription link. An individual key does not need to download a server list from a subscription URL.
This method is useful when the QR code is displayed on another device — for example, on a computer while HAPP is installed on your phone.
If the QR code is on the same phone, it is usually easier to copy the original key or link and import it from the clipboard.
Some access providers include an Add to HAPP button, or a similar option, in their account dashboard or message.
Tap it on the device where HAPP is installed. If the browser asks for permission to open HAPP, confirm the action and complete the import in the app.
If the button does not open HAPP, copy the link and use the clipboard import method instead.
Available connections should appear on the main screen. If they are grouped inside a collapsed section, expand it.
If the servers are visible, the connection details have been imported successfully. We will turn on the connection and test it in the next step.
Copy the key or link again and return to HAPP immediately. Check that your system has allowed clipboard access.
Make sure you copied the entire connection data without any extra text. Check with your provider that the data is compatible with HAPP.
Do not edit characters inside the key at random — it is better to request the original connection details again.
Check that your regular internet connection is working and refresh the subscription. If the list is still empty, ask your provider whether your access is active and whether the subscription contains any connections.
If a loading error appears, save the error message so you can provide it to support.
You only need one current copy to connect. First make sure the correct subscription has loaded successfully, then remove any duplicate if necessary.
Once the servers appear, choose one and turn on the connection.