Happ Configurations: Subscription Link vs Single Config

What a configuration actually contains

It's essentially an encrypted data set for Xray-core: server address, protocol, port, and encryption keys. The Happ app reads these parameters to build a secure connection — without a valid configuration, there's simply no connection to make. That's why it should only come from the service Telegram bot, never from a random site or forum post.

Single config vs subscription link

There are two ways to load access into Happ:

• Single config — a fixed set of parameters for one specific server, with no automatic updates.
• Subscription link — a whole bundle of servers that refreshes automatically, so the app picks up new addresses without any manual editing.

For most use cases — especially when you need to quickly jump to a lower-latency server for a game or stream — the subscription link is the more convenient option; it needs less upkeep and makes switching easier.

Loading a configuration into the app

Keys and links are issued in the Happ Telegram bot. From there you copy them into the app, usually by importing the link or scanning a QR code, depending on the platform. A full walkthrough for Windows, macOS, Linux, Android, iOS, and Smart TV is on /en/setup/.

Where keys are stored and issued

Every key and configuration is tied to your account in the service Telegram bot — that's also where you see which links are currently active and request new ones. More detail is on /en/keys/, and the general logic of handling configurations inside the app is covered on /en/configurations/.

When it's time to switch configurations

If a server starts lagging — video buffering, ping spiking mid-match — try another configuration from the same subscription link first; it's usually faster than troubleshooting a single fixed config. Browse the server list and picking tips on /en/servers/.

Frequently asked questions