Happ app setup: connect 404 VPN on iPhone, iPad and Apple TV
Happ is a free VLESS and Xray client for iPhone, iPad, Mac, Apple TV and Android, and it is the app we recommend on Apple devices until the 404 VPN iOS app is released: it supports every transport we serve and keeps the subscription up to date. Install it from the App Store, import your subscription link from the dashboard, press Connect. The three settings below are the only ones worth changing.
Install
- iPhone, iPad, Mac: App Store, search "Happ Proxy Utility".
- Android: Google Play, same name. Without Play, the APK is on the developer's GitHub releases page.
- Android TV: the TV version of Google Play.
Happ is made by an independent developer and is not a 404 VPN product. It sees only the server address and key you give it, like any VPN client.
Import your subscription
- Open the VPN tab of your dashboard and copy the subscription link.
- In Happ tap the plus button and choose Import from clipboard.
- A group appears with several entries for each location, one per transport.
- Tap the group to let Happ pick the best entry, or tap one entry to pin it.
- Press Connect. Approve the VPN permission dialog on first use.
Three settings to change
- Auto-update subscription. Settings, Subscriptions, set the interval to 12 or 24 hours. New servers and transports then appear without re-importing.
- Block traffic when disconnected. Settings, VPN. This is the kill switch: when the tunnel drops, the phone stays offline rather than leaking to the open network.
- Connect on demand on iOS and macOS, or Auto-connect on Android. The tunnel comes back after a reboot or after iOS unloads the app.
Reading the log
When a connection fails, Happ keeps a log under Settings, Logs. The last few lines tell you the cause:
| Log line | Meaning |
|---|---|
handshake: EOF | the network cut the Reality handshake; use the WebSocket entry |
x509: certificate | the device clock is wrong |
dial tcp ... i/o timeout | the port is blocked or the network is down |
invalid user | the key was reissued or the plan ended; refresh the subscription |
The full list is in Reality not working.
Per-app routing
Settings, Routing, Excluded apps. Add banking apps that refuse VPN addresses; they go straight to the internet while everything else uses the tunnel. Android and Android TV support this; iOS does not allow per-app VPN routing for third-party apps.
FAQ
Is Happ free?
Yes. Everything needed for 404 VPN is in the free version.
Happ or the 404 VPN app?
On Android, Windows, macOS and Linux use the 404 VPN app: you sign in and it handles servers on its own. Happ is the choice for iPhone, iPad and Apple TV, where our app is not released yet, and for people who want manual control over each entry.
Why does Happ show a red ping next to the server?
Its ping uses ICMP, which many servers do not answer. Ignore it and connect; the real latency shows after connecting.
Can I use Happ on Windows?
Use the 404 VPN app for Windows instead; see the Windows guide.