> 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/mobile/ios.md).

# iOS

iOS lets you configure a per-Wi-Fi HTTP proxy with authentication built into the UI — easier than Android.

## Per-Wi-Fi proxy

1. **Settings → Wi-Fi → {your network → ⓘ}**.
2. Scroll to **HTTP Proxy → Configure Proxy → Manual**.
3. Fill in:
   * Server: `gate.helodata.io` (or ISP IP)
   * Port: `7777`
   * **Authentication**: on
   * Username: full proxy username
   * Password: sub-user password
4. **Save**.

\[screenshot: iOS HTTP Proxy form]

This affects all apps on the device when connected to that Wi-Fi — including Safari, Mail, App Store, and any app that uses the system HTTP stack.

## What doesn't work

* **Cellular data** — there's no system proxy field for cellular. Use Wi-Fi or [Shadowrocket](/integrations/mobile/shadowrocket.md).
* **Apps with their own network stack** — some games, some banking apps. Use Shadowrocket to force OS-level routing.
* **SOCKS5** — iOS native UI doesn't support SOCKS proxies. Use Shadowrocket.

## Auto / PAC config

In the Configure Proxy screen, pick **Automatic** and supply a PAC URL — useful for switching between targets without re-typing creds:

```javascript
function FindProxyForURL(url, host) {
  if (host === "example.com")
    return "PROXY gate.helodata.io:7777";
  return "DIRECT";
}
```

Host a PAC file on any HTTPS URL and point iOS at it.

## Verify

In Safari, visit `https://ipv4.icanhazip.com` — expect a helodata IP, not your home network's.

## Common pitfalls

* **Per-network only** — different Wi-Fi networks each need their own proxy config.
* **Captive portals** — iOS shows the captive portal regardless of proxy, but post-login traffic uses the proxy. If portal pages don't render, briefly disable the proxy.
* **App-bound certs** — apps that pin their own TLS certs won't accept any proxy intercepting their connections. helodata doesn't intercept (it's a forwarder), so this rarely matters — but if you also run a MITM debug proxy alongside, that breaks pinning.


---

# 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/mobile/ios.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.