How to set up 404 VPN on macOS
You need a Mac with macOS 12 Monterey or newer, the 404 VPN app from our site and a 404 VPN account. One universal build runs on Apple Silicon and Intel. Setup takes about three minutes; the app asks for your password once to install the helper that creates the tunnel.
How to install and connect
- Download 404vpn-macos.dmg and open it.
- Drag 404 VPN to the Applications folder, then open it from Applications.
- Sign in with your email or Telegram. No account yet? Create one; the first day is free.
- Click Connect. macOS asks for your password or Touch ID to install the helper. This happens once.
- Open What is my IP and check that the country is the server's.
Common problems on macOS
"404 VPN cannot be opened"
macOS blocks apps downloaded outside the App Store the first time. Open System Settings, Privacy & Security, scroll down and click Open Anyway next to 404 VPN, then open the app again.
The helper was not installed
If you cancelled the password prompt, quit the app and open it again; it asks once more. On macOS 15 check System Settings, General, Login Items & Extensions, and allow 404 VPN there.
Connected, but Safari cannot find sites
Turn off iCloud Private Relay while 404 VPN is connected: System Settings, your name, iCloud, Private Relay. It competes with any VPN for the same traffic.
The tunnel does not come back after sleep
Open the app and click Connect again. If it happens every time, quit other VPN apps: two VPNs on one Mac interfere with each other.
FAQ
Is 404 VPN in the Mac App Store?
Not yet. Our site is the only official source. Compare the file with 404vpn-macos.dmg.sha256: shasum -a 256 404vpn-macos.dmg.
Does it work on macOS 11 Big Sur?
No. The app needs macOS 12 or newer.
Can I use the built-in macOS VPN settings instead?
No. The built-in client supports IKEv2, L2TP and IPsec profiles, not VLESS.
Will my account work on my iPhone too?
Yes. On iPhone use Happ or v2rayTun with your subscription link; see the iPhone guide.