macOS

System-wide proxy for any app honoring macOS network settings — Safari, Mail, App Store, most third-party apps.

System Settings UI

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 (or ISP IP), Port: 7777
   • Tick Proxy server requires password, fill in username and password
4. OK → Apply.

[screenshot: macOS Proxies pane]

See Safari for the same flow with screenshots.

CLI tools

curl, wget, brew, npm, and most Unix tools read environment variables. Add to ~/.zshrc or ~/.bash_profile:

export HTTP_PROXY="http://helo_s1a2b3c4d5e-type-res-region-us:[e-mail]:7777"
export HTTPS_PROXY="$HTTP_PROXY"
export NO_PROXY="localhost,127.0.0.1,*.local"

Reload shell, then curl https://ipv4.icanhazip.com should report a helodata IP.

To set only for the current shell, omit the export from rc files and run them directly.

networksetup (scripted)

# Turn on
sudo networksetup -setwebproxy "Wi-Fi" gate.helodata.io 7777 on \
     "helo_s1a2b3c4d5e-type-res-region-us" "PASSWORD"
sudo networksetup -setsecurewebproxy "Wi-Fi" gate.helodata.io 7777 on \
     "helo_s1a2b3c4d5e-type-res-region-us" "PASSWORD"

# Turn off
sudo networksetup -setwebproxystate "Wi-Fi" off
sudo networksetup -setsecurewebproxystate "Wi-Fi" off

Replace Wi-Fi with your active interface name (find it via networksetup -listallnetworkservices).

Per-app vs system

GUI apps honor the System Settings proxy. CLI apps honor envvars. They're two systems — make sure both are configured for unified behavior.

Verify

curl https://ipv4.icanhazip.com

Common pitfalls

• .local bypass — macOS bypasses .local and link-local IPs by default. Useful for Bonjour but watch your bypass list.
• networksetup requires sudo to modify proxies on a shared system.
• Big Sur+ requires you to "Apply" in System Settings after editing — without it the change doesn't take effect.