# 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.helodata.com/integrations/browsers/safari.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.