> ## Documentation Index
> Fetch the complete documentation index at: https://docs.eclipseproxy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Mobile apps (iOS / Android)

> Using EclipseProxy on iOS and Android via VPN/proxifier apps

Mobile OSes don't have system-wide HTTP proxy support out of the box (Wi-Fi-level only). For app-specific or system-wide proxying you need a helper app.

## Android

### Super Proxy (recommended)

[Super Proxy](https://play.google.com/store/apps/details?id=org.proxydroid) routes all device traffic through your proxy.

1. Install Super Proxy
2. Add new proxy:
   , **Protocol:** HTTP or SOCKS5
   , **Host, port, username, password** from EclipseProxy generator
3. Save and connect

You'll see a VPN icon in the status bar: that's normal, Super Proxy uses Android's VPN API.

### Other Android proxy apps

* **ProxyDroid** (rooted devices only)
* **Drony** (also VPN-based)

### Wi-Fi-level proxy

Settings → Wi-Fi → long-press network → Modify → Advanced → Proxy → Manual. Enter host and port. Credentials prompted.

**Limitation:** only proxies HTTP from the system browser. Most apps ignore it. Use Super Proxy for app-level traffic.

## iOS

### Potatso / Shadowrocket (recommended)

Premium apps from the App Store that support HTTP and SOCKS5 system-wide.

1. Open Potatso (or Shadowrocket)
2. New proxy → HTTP or SOCKS5
3. Server, port, credentials
4. Connect

### Wi-Fi-level proxy

Settings → Wi-Fi → tap your network → Configure Proxy → Manual. Enter server and port. Username/password fields available.

**Same limitation as Android**: only system-aware traffic uses it.

## Common issues

<Accordion title="Mobile proxy doesn't work in Potatso on iOS">
  Check protocol (HTTP port 5555, SOCKS5 port 6666), verify full username includes geo and session segments, test in Safari to isolate the issue.
</Accordion>

<Accordion title="Octo browser on mobile can't load proxy">
  Set port explicitly (5555 for HTTP, 6666 for SOCKS5). If copied from desktop, verify port matches what Mobile expects.
</Accordion>

<Accordion title="Mobile proxy format">
  Mobile uses `_` between segments (not `-` like Residential):

  ```
  emob_yourname:password_country-US_city-austin_session-X_lifetime-30
  ```

  See [Mobile setup](/setup/mobile) for full format.
</Accordion>