Configuring Happ on iPhone: From Install to Connected
Happ for iPhone runs on the Xray-core engine and draws its server settings from an access key the service's Telegram bot provides. Let's go through the entire journey — from installing the app to a live connection.
Step 1. Put the app on your iPhone
Head to the iOS download page and install Happ. Be sure to use the iOS-specific link — versions made for other platforms just won't open on an iPhone.
Step 2. Obtain an access key from the Telegram bot
Launch the service's Telegram bot — either on the iPhone itself or on another device — and ask for an access key or subscription link. The bot frequently sends a QR code as well, which is convenient to scan directly from Happ.
Step 3. Link the subscription in the app
Within Happ on iPhone, go to the add-subscription section: paste the link you got or scan the QR code using the app's camera. A new connection appears in the profile list immediately.
Step 4. Allow the VPN configuration and switch it on
The first time you try to connect, iOS presents a system prompt to add a VPN configuration — grant it in your device settings. From then on, simply choose a server in the app and toggle the connection switch.
iPhone won't connect — what to examine
If a connection still won't form after every step, verify that you approved the system VPN configuration prompt, and confirm no stray spaces crept in while pasting the key. Should it remain broken, turn to the troubleshooting guide.
Frequently asked questions
Must my iPhone be jailbroken to install Happ?
No — the app installs and works on an ordinary iPhone with no jailbreak whatsoever.
Why does iOS request permission when I connect?
That's iOS's usual system prompt for adding a VPN configuration — Apple displays it the first time you launch any VPN app.
Can I try Happ on iPhone at no cost?
Yes — the Telegram bot provides a 3-day trial you can enable before committing to a paid plan.
How do I know the key was added properly?
As soon as the link is pasted, a fresh connection profile listing the available servers shows up in the app.
Get connected through the Telegram bot
Set up Happ on your iPhone and ask the Telegram bot for an access key — you'll be connected within minutes.
Get a key