HAPP settings include the names of networking technologies and connection parameters. This page explains what they mean and when you may need them.
You do not need to study the entire guide before your first connection. If you simply want to start using the app, go to the step-by-step HAPP setup.
Several different components are involved in a connection.
| Term | What it means |
|---|---|
| HAPP | The application on your device that uses connection settings to connect to a server |
| Server | A remote computer that accepts the connection and forwards traffic routed through it |
| Key | Ready-made data for a single connection |
| Subscription link | An address that the app uses to retrieve and update a set of connections |
| Configuration | A set of parameters required for a connection to work |
The installed app and access to a server are separate things. That is why, after installing HAPP, you still need to add a key or subscription.
Learn more about keys and subscriptions →
If you are still choosing a provider, read how to choose and buy a subscription for HAPP: what to check and which terms to consider before purchasing.
Xray is a software core used for handling network connections. HAPP uses it to perform networking tasks.
The app interface lets you add subscriptions, choose servers, and change settings. The core performs the corresponding operations with connections and traffic.
For normal HAPP use, you do not need to install Xray separately on your device.
A protocol defines the rules for exchanging data between the client and the server.
You may see names such as VLESS, VMess, Trojan, Shadowsocks, and others in configurations. The client and server must use compatible parameters.
The protocol is usually already specified in the key or subscription you receive. If you change it arbitrarily, the connection may stop working.
VLESS is one of the protocols used to connect to a proxy server.
A key beginning with vless:// contains the parameters for this type of connection. You can import it into HAPP as a complete string.
The name VLESS alone does not describe every property of the connection. The transport and security parameters also matter.
TLS and REALITY are related to protecting the connection between the client and the server. You may see these names next to VLESS in a configuration description.
TLS is a technology for secure data exchange that is also used in many other networking tasks, including HTTPS.
REALITY is a connection protection mechanism implemented in Xray.
These parameters must match the server configuration. When you import a ready-made key, they are usually included with the rest of the connection data.
You do not need to choose between them manually for your first connection.
Transport defines how connection data is carried. You may see names such as TCP, WebSocket, gRPC, XHTTP, and others in the settings.
The connection protocol, transport, and security mechanism serve different purposes, even though they are often listed together in a server description.
If your provider supplied a ready-made configuration, keep the transport specified in it. Changing it only in the app does not reconfigure the server.
TUN is a virtual network interface. It allows the operating system to pass IP packets to an application that processes the connection.
In applications of this type, TUN mode is used to handle traffic at the device level, including traffic from programs that do not have their own proxy settings.
Which connections enter the TUN interface and where they go next depends on the operating system and routing rules. Therefore, enabling TUN does not necessarily mean that absolutely all traffic is sent through a single server.
The availability of this mode, its name, and the permissions it requires may differ between platforms.
A system proxy is an operating system setting that tells applications which proxy to use for supported connections.
Not every application uses this setting. This means that a browser may work through the proxy while another application connects directly.
TUN and the system proxy are different ways of directing traffic for processing. The right choice depends on the device and the task.
DNS helps convert a domain name into an IP address.
For example, before connecting to a website, your device usually needs to determine which address corresponds to its domain name.
If a DNS request fails, a website may not open even when other parts of the connection are working correctly. However, not every loading problem is caused by DNS: the issue may also be related to the server, the network, or the website itself.
Do not change DNS settings at random whenever something stops working. First determine what exactly is failing.
Routing is the set of rules that determines which path a connection should take.
For example, some connections may go through the selected server while others go directly. Rules may use the domain, IP address, and other properties.
This explains why enabling HAPP does not necessarily change the route for every website and application.
Direct usually means connecting to a resource directly, without sending the connection through the selected proxy server.
Proxy usually means sending the connection through the configured proxy.
The exact behavior depends on the routing rules and configuration in use.
Ping is a measure of latency during a connection test. It is usually shown in milliseconds, for example 80 ms.
A lower value means lower latency under the conditions of that test. It does not show download speed and does not guarantee that every application will work equally well.
In HAPP, the result also depends on the test method: checking connectivity to the server address and sending a request through the proxy to a test resource measure different parts of the path.
Timeout means that an operation did not finish within the allowed time.
What matters is where the error appeared:
The word Timeout alone does not identify the exact cause. Troubleshooting requires the context of the error and the results of other checks.
What to check if HAPP is not working →
For your first setup, it is usually enough to:
You do not need to study or change all of the settings listed above in advance. Return to this guide when you encounter an unfamiliar term or have a specific task.