Keys for Happ: what they are, where to get them and how to add them
- Author
- Ekaterina Lebedeva, Knowledge Base editor
- Reviewed by:
- Artem Volkov
- Fact-checked:
- Published:
- , updated
- Guide version:
- 1.0
In short
“Keys for Happ” is the everyday name for whatever connects the app to a server: a single server configuration, a subscription to a list of servers, or an encrypted happ://crypto link. You get them from your own server or a third-party provider and add them by link, QR code, clipboard or by hand.
Happ has no servers of its own, so without a key the app is an empty list. “Key” in a search usually means one of three things: the configuration of one server with an address and an access secret, a subscription (an address with a list of such configurations that gets updated), or an encrypted happ://crypto link, where the address and server settings are hidden from the user. The source is also one of two: your own server on the Xray-core engine or a subscription from a third-party provider. All of it is added in the same ways: a link from the clipboard, scanning a QR code, a deeplink or entering the parameters by hand.
What people call a key for Happ
Happ is a client app on the Xray-core engine, not a service with servers of its own. The word “key” in searches like “keys for happ” or “happ keys” in practice means one of three things, and what it is decides how you add it.
A configuration holds the parameters of one server: the protocol, address, port and an access key, which is a UUID or a password. It is static and does not update itself. A subscription is an address where Happ regularly requests a list of such configurations from a provider. An encrypted happ://crypto… link is the same subscription, but with the address and server parameters hidden from the app user.
The difference in practice is simple: a configuration is one server here and now, and a subscription is a source that brings you current servers by itself.
Where keys come from: your own server or a provider
There are two sources for Happ, and both are equally legitimate from the app's point of view: it simply connects to whatever it is given.
The first is your own server on Xray-core, set up on your own or a rented machine. Such a key gives you full control over the protocol, the address and the settings, but you have to administer the server yourself.
The second is a subscription from a third-party provider. The provider sets up and runs the servers and gives the customer a ready link or subscription; the terms, plans and support are set by the provider, not by the developer of Happ. Atlas VPN is one example of a provider; you can see its plans on the pricing page.
Free keys from random sources on the internet are not the same as a key from your own server or from a provider with clear terms. Who owns such a server, what it can see and why a key may stop working without warning are all reasons to be careful. This site does not link to such sources.
How to add a key to the app
Happ accepts all three kinds of keys in the same ways: from the clipboard, by scanning a QR code, through a deeplink, or by hand with the “+” button and the manual entry option. The only difference is what exactly you paste.
| What you have | What to do in Happ |
|---|---|
A link like vless://, vmess://, trojan://, ss://, socks:// or hysteria2:// | Copy it to the clipboard or scan its QR code. Happ recognizes the protocol itself |
An encrypted happ://crypto… link | Add it the same way; the address and server parameters inside it stay hidden |
| A subscription address from a provider | Add it once, and after that Happ updates the server list on a schedule |
| Only separate parameters: address, port, UUID or password | Use the “+” button, choose manual entry, pick a protocol and fill in the fields |
A detailed breakdown of each method with steps and common mistakes is on the How to add a configuration to Happ page.
How to pick material for your task
| Task | Where to go |
|---|---|
| Understand the configuration format and check it before importing | Configuration for Happ (see the Import section for the import formats) |
| Deal with a subscription: how to add it, update it and read its status | Subscription in Happ (see the Import section) |
| Weigh the risks of a free key before using it | Read the warning above; this site does not link to free key sources |
| Add a link, a QR code or an encrypted subscription step by step | How to add a configuration to Happ |
| Choose a server by protocol, location and ping once you already have a key | Servers for Happ |
| Get one day of free access before paying a provider | Free trial |
How this connects to other sections
The keys section answers “what is it and where do I get it”, and from there the route splits in two. How to technically add a key you already have is the job of the Import section: it covers a link and the clipboard, a QR code, happ://crypto and JSON separately, with steps and typical import errors.
What to do with a key after the server is added, choosing a specific node from the list, belongs to the Servers section: by protocol, by location and by ping. If you have no key yet and want to try Happ with a working server without your own setup, a short free one-day access when you come from this site is described on the Free trial page.
Key takeaways
- “Key for Happ” is not an official term: it covers a single server configuration, a subscription to a list of servers and an encrypted happ://crypto link.
- Happ connects to a server but does not provide one: you get a key either from your own server or from a third-party subscription provider.
- A configuration describes one server and does not update itself; a subscription is an address that Happ queries periodically for the current list of servers.
- An encrypted happ://crypto link hides the subscription address and server parameters even from the person who added it.
- Free keys from random sources behave differently from a key from your own server or a trusted provider, and the risks are worth weighing carefully.
Frequently asked questions
How is a key for Happ different from an ordinary password?
A password usually proves your identity in one service. A key for Happ is a server address together with an access secret: without the address the password is useless, and without the secret the server will not let you in even at the right address. That is why a key is passed on whole, as a link, a QR code or a file, not as a single word or a set of digits like an account password.
Can I use Happ at all without a key?
No. After installation the server list in Happ is empty, because the app is a client on the Xray-core engine without its own network of servers. The first thing to do after installing is to add a configuration, a subscription or an encrypted link. Without this step the app only has settings and nothing to connect to.
Where do I get a key for Happ if I have no server of my own?
There are two ways: set up a server on Xray-core yourself, for example on a rented machine, or get a ready subscription from a third-party provider. Your own server gives full control but needs administration; a provider's subscription is easier at the start but depends on the terms of that specific company, which are unrelated to the developer of Happ.
Why do searches for Happ keys often offer free options?
Demand for ready-made access is higher than for setting up a server yourself, and free links look like the fastest solution. They have a downside, from an unknown server owner to a key that suddenly disappears, so it is worth thinking carefully about who runs the server and what it can see before you use one.
Which way of adding a key should I choose: a link, a QR code or a subscription?
It depends on what you were given, not on personal preference. A one-off protocol link is pasted from the clipboard or scanned as a QR code, an encrypted happ://crypto link is added the same way, and a subscription address is entered once and then only refreshed. To the app all options are equal; the difference is only in how convenient they are to pass around.
Do I need a separate key for each device?
Usually a key or subscription can be used on several devices of one person, unless the provider limited the number of connections with a separate parameter. A device limit is the decision of whoever issued the key, not a property of Happ itself. If the same key refuses to work on a second device, the cause is usually on the server or provider side, not in the app.
Related sections
Sources
- Happ documentation: adding a configuration and a subscription — accessed September 28, 2026
- Happ documentation — accessed September 28, 2026