Safari

Safari on macOS has no built-in proxy UI — it follows the macOS system proxy. Configuration is at the OS level.

Configure

1. System Settings → Network → {Active interface, e.g. Wi-Fi} → Details… → Proxies.
2. Tick Web Proxy (HTTP) and Secure Web Proxy (HTTPS).
3. For each:

   • Server: gate.helodata.io, Port 7777 (or your ISP IP)
   • Tick Proxy server requires password
   • Username: full proxy username (e.g. helo_s1a2b3c4d5e-type-res-region-us)
   • Password: sub-user password
4. Click OK → Apply.

[screenshot: macOS Proxies pane with HTTP and HTTPS configured]

Scope

This affects all apps on the active network interface — not just Safari. Switch networks (e.g. plug in Ethernet) and the proxy doesn't follow. Configure each interface you use, or scope by network location:

• System Settings → Network → ⋯ → Locations → Edit Locations… — create a "helodata" location and switch via the Apple menu.

SOCKS5 instead

In the Proxies pane, tick SOCKS Proxy, fill in gate.helodata.io:7777 (or your ISP IP), enable authentication. Safari will route through SOCKS5; DNS is proxied by default on macOS.

Verify

Visit https://ipv4.icanhazip.com in Safari. Expect a helodata IP.

Common pitfalls

• VPN active — macOS VPN typically bypasses the proxy. Disconnect VPN or scope the proxy to a different location.
• Bypass list — *.local, 169.254/16, and localhost are excluded by default. Useful, but if you've added entries don't accidentally exclude what you wanted to proxy.
• Captive portals — macOS proxy applies even during captive-portal detection; that may break the portal flow. Temporarily uncheck the proxy boxes during initial Wi-Fi onboarding.