> For the complete documentation index, see [llms.txt](https://docs.helodata.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.helodata.com/integrations/browsers/safari.md).

# 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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.