← All articles

Happ app setup: connect 404 VPN on iPhone, iPad and Apple TV

Setup · October 27, 2026 · Updated November 18, 2026 · 2 min read · 404 VPN team

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

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

  1. Open the VPN tab of your dashboard and copy the subscription link.
  2. In Happ tap the plus button and choose Import from clipboard.
  3. A group appears with several entries for each location, one per transport.
  4. Tap the group to let Happ pick the best entry, or tap one entry to pin it.
  5. Press Connect. Approve the VPN permission dialog on first use.

Three settings to change

  1. Auto-update subscription. Settings, Subscriptions, set the interval to 12 or 24 hours. New servers and transports then appear without re-importing.
  2. 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.
  3. 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 lineMeaning
handshake: EOFthe network cut the Reality handshake; use the WebSocket entry
x509: certificatethe device clock is wrong
dial tcp ... i/o timeoutthe port is blocked or the network is down
invalid userthe 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.