How to Set Up Happ Proxy Mode
Happ Proxy mode lets you route only selected apps through the server without creating a system-wide VPN tunnel. Setup takes just a few minutes, and desktop systems have a dedicated utility that makes integrating it with other software easier. Here's the process step by step.
What you need before you start
You need an active key or subscription link from the Happ service Telegram bot, plus the app installed on your platform. If you haven't installed it yet, download it for your system on /en/setup/ and add the key as you would for a regular connection.
Turning on proxy mode in the app
The general steps are:
- Open Happ and confirm your key is already added and active.
- In the app's settings, switch the connection mode from VPN to Proxy.
- The app starts a local proxy server based on Xray-core and shows the address and port to connect to.
- Test the connection by opening a site that shows your IP — it should switch to the server's address.
For a full breakdown of the mode and how it differs from VPN, see /en/proxy/.
Setting up with the Happ Proxy Utility on desktop
Windows, macOS, and Linux have a dedicated Happ Proxy Utility that simplifies working with the proxy: it lets you quickly turn proxying on and off and route specific apps through it without manually entering the address and port in every program's settings. Download the utility and read the instructions on /en/proxy-utility/.
Routing a specific app through the proxy
After enabling Proxy mode in Happ, copy the local proxy's address and port and enter them in the network settings of the app or browser you want to route — or use the Happ Proxy Utility if it supports automatic app binding. The rest of the device's traffic keeps going directly, bypassing the server.
If the proxy won't connect
The most common causes are an expired key or an app that uses its own network settings and ignores the system proxy. Check that the key is still valid in the Telegram bot and review the specific program's settings; if the issue persists, check /en/support/not-working/.
Frequently asked questions
Do I need a separate key to set up proxy mode?
No, it uses the same key or subscription link as a regular VPN connection in Happ.
What's the Happ Proxy Utility for?
It simplifies working with the proxy on desktop — turning it on or off and binding specific apps without manually setting the address and port in each program.
Can I use VPN and Proxy at the same time?
The app switches between modes, so only one is active at a time — VPN or Proxy — but you can switch between them whenever you need to.
What if an app can't detect the proxy?
Check that the app's network settings have the correct local proxy address and port shown in Happ, and that your key is still active.
Connect via the Telegram bot
Turn on Happ Proxy mode in the app or via the Happ Proxy Utility to route only the apps you need through the server.
Get a key