Section: Errors and diagnostics · Entire Knowledge Base
Table of Contents
First, fix the symptomTest the internet without HappCheck your subscription and server listEliminate mode and profile conflictsCheck permissions and background workCheck the resultIf it doesn't helpFirst, fix the symptom
Write down three things: which device the error is occurring on, how long it takes before it disconnects, and whether the message text appears. Take an anonymized screenshot. It should not contain a personal link, QR code, server address or other access data.
It is important to distinguish this scenario from two similar problems:
- Happ remains in the connection state and does not report the result – use the instruction on the Hang on connection;
- The app ends the attempt with a timed message — use the PRO material Connection timeout.
Test the internet without Happ
Disable Happ and open a few regular websites. If the internet without the app is also unstable, restore the original connection first. Switch between Wi-Fi and your mobile network, or try a different Wi-Fi network. The result on the second network helps you understand whether the error is related to a specific connection.
Do not change DNS, routing, and system settings at the same time. Run one retest after each step, otherwise you won't be able to determine which step was triggered.
Check your subscription and server list
Open your personal account and make sure that access is active. Then, update the existing record in Happ with the current version of the application. Do not re-import the same link until you have verified the update: re-importing may create a separate record or duplicate servers.
If there are several available options in the list, select another one and reconnect. When only one option is disabled, use a separate instruction "One Happ server is down". If the entire list is not available, proceed to diagnostics of all servers.
Eliminate mode and profile conflicts
Mode availability may vary depending on the operating system and Happ version. If you've previously changed TUN, system proxy, routing, or application exceptions, temporarily revert to the last working configuration. Don't create a new rule on top of an untested old one.
On your phone, check to see if there is another active system connection profile. On the computer, completely terminate other network programs that change the system proxy or create a virtual network adapter. After that, restart Happ and perform one test.
Check permissions and background work
On Android, disabling immediately after minimizing may be due to background work system limitations. Leave Happ open on the screen and compare the result. If the connection is saved only when the app is open, continue with the instructions on Android background operation.
On your iPhone, retry the normal connection and check if the system prompt appears. On Windows and macOS, pay attention to security software warnings and system permissions of the network component. Do not disable the entire system protection.
Check the result
After each change:
- Disconnect the previous connection completely.
- Close and reopen Happ.
- Select a single record to be verified.
- Start the connection.
- Wait for the original symptom to recur or disappear.
- Open the regular website and check the connection.
If the problem disappears, revert the rest of the settings one at a time and repeat the test. In this way, you can identify the specific change that caused the break.
If it doesn't help
Prepare the OS version, Happ version, error time, network type, and the exact message text for support. Specify whether the outage is repeated on a different network and with a different record. Before sending the log, remove personal links, keys, and addresses.
You can start a general diagnosis with the article "What to do if Happ connection fails". The status of the subscription is checked separately in the personal account.
Frequently Asked Questions
Do I need to reinstall Happ right away?
No. First, check the internet, subscription, other record, connection mode, and system permissions. Reinstalling does not fix the external network or access expiration issue.
Why does another record connect normally?
This narrows down the problem to a specific record or its availability. Don't delete your work record or share it when you ask for help.
What to send to support?
System version and Happ, exact time, error text, test result on the second network and an anonymized screenshot.
Sources
The names of interface items may differ between the versions of the application and the operating system. Check the current version before changing the settings.
Keep the exact error text and device information by hiding your personal information beforehand.
Open supportUpdate history
— the Russian version of the manual has been published, internal navigation, FAQ and structured data have been added.