# iOS

Source: https://docs.evomi.com/proxy-instructions/integration-guides/ios/

This guide covers how to configure and use Evomi proxies on iPhones and iPads. iOS has limited native proxy support (HTTP only, no SOCKS5), so a dedicated proxy app is recommended for full functionality.

## Prerequisites

- An active Evomi proxy subscription
- Your Evomi proxy credentials (username and password)
- An iPhone or iPad running iOS 15 or later

## Method 1: Using Shadowrocket (Recommended)

[Shadowrocket](https://apps.apple.com/us/app/shadowrocket/id932747118) ($2.99, one-time purchase) is the most popular iOS proxy client. It supports HTTP, HTTPS, SOCKS5, Shadowsocks, and many other protocols. It routes traffic through a local VPN service and offers rule-based routing per app or domain.

### Setup Steps

1. Install **Shadowrocket** from the App Store.
2. Open Shadowrocket and tap the **+** button in the top-right corner to add a new server.
3. Configure the proxy:
   - **Type**: Select `HTTP` or `SOCKS5` depending on which port you want to use
   - **Address**: `rp.evomi.com`
   - **Port**: `1000` for HTTP or `1002` for SOCKS5
   - **User**: Your Evomi username
   - **Password**: Your Evomi password, e.g. `your_password_session-anychars_mode-speed`
4. Tap **Save** (top-right).
5. Back on the main screen, make sure your new server is selected (checkmark next to it).
6. Toggle the **Connect** switch at the top to enable the proxy. iOS will prompt you to allow the VPN configuration -- tap **Allow**.
7. Verify your connection by opening Safari and navigating to `https://ip.evomi.com/s`. The displayed IP should be the proxy IP.

Shadowrocket supports advanced routing rules. Under the **Config** tab, you can set up rules to route specific domains or apps through the proxy while keeping others on a direct connection.

## Method 2: Using Potatso Lite (Free Alternative)

[Potatso Lite](https://apps.apple.com/us/app/potatso-lite/id1239860606) is a free iOS proxy client that supports SOCKS5 and Shadowsocks protocols.

### Setup Steps

1. Install **Potatso Lite** from the App Store.
2. Open the app and tap **Add a Proxy**.
3. Select **Manual Input**.
4. Configure:
   - **Type**: `SOCKS5`
   - **Host**: `rp.evomi.com`
   - **Port**: `1002`
   - **User**: Your Evomi username
   - **Password**: Your Evomi password, e.g. `your_password_session-anychars_mode-speed`
5. Tap **Done** to save.
6. On the main screen, tap **Start** to enable the VPN connection. Allow the VPN configuration when prompted.
7. Verify at `https://ip.evomi.com/s`.

## Method 3: Manual Wi-Fi Proxy Configuration (HTTP Only)

iOS natively supports HTTP proxy configuration per Wi-Fi network. This method does support username/password authentication, but it is limited to HTTP proxies only and does not cover mobile data or SOCKS5.

### Steps

1. Open **Settings** > **Wi-Fi**.
2. Tap the **(i)** icon next to your connected Wi-Fi network.
3. Scroll down and tap **Configure Proxy**.
4. Select **Manual**.
5. Fill in the details:
   - **Server**: `rp.evomi.com`
   - **Port**: `1000`
   - **Authentication**: Toggle **On**
   - **Username**: Your Evomi username
   - **Password**: Your Evomi password, e.g. `your_password_session-anychars_mode-speed`
6. Tap **Save** (top-right).
7. Verify at `https://ip.evomi.com/s`.

This method only works for HTTP proxies on the current Wi-Fi network. It does not apply to mobile data, and some apps may ignore the system proxy setting. For full coverage, use Shadowrocket or Potatso Lite instead.

## Evomi Proxy Endpoints

| Proxy Type | HTTP | HTTPS | SOCKS5 |
|---|---|---|---|
| **Residential** | `rp.evomi.com:1000` | `rp.evomi-proxy.com:1001` | `rp.evomi.com:1002` |
| **Mobile** | `mp.evomi.com:3000` | `mp.evomi-proxy.com:3001` | `mp.evomi.com:3002` |
| **Datacenter** | `dcp.evomi.com:2000` | `dcp.evomi-proxy.com:2001` | `dcp.evomi.com:2002` |

HTTPS endpoints use the `evomi-proxy.com` domain — that is the hostname our TLS certificate covers, and it reaches the same servers. A client that verifies certificates will reject the `evomi.com` form on the HTTPS port.

## Verifying Your Connection

After enabling the proxy, open Safari and navigate to:

```
https://ip.evomi.com/s
```

The displayed IP should be the proxy server's IP. If it shows your real IP, the proxy is not active.

## Tips and Troubleshooting

- **Credentials**: Double-check the hostname, port, username, and full password string (including `_session-` and `_mode-` parameters).
- **SOCKS5 requires an app**: iOS does not natively support SOCKS5 proxies. You must use Shadowrocket, Potatso Lite, or a similar app.
- **Apps ignoring proxy**: Some apps may bypass the system Wi-Fi proxy setting. A VPN-based proxy app like Shadowrocket ensures all traffic is routed correctly.
- **Toggle Airplane mode**: If you experience connectivity issues after changing proxy settings, toggling Airplane mode can reset the network stack.
- **Disable when not needed**: Remember to disconnect the proxy (or toggle off the VPN in Shadowrocket/Potatso) when you are done to restore normal internet access.
- **Battery usage**: VPN-based proxy apps may slightly increase battery consumption. This is normal since all traffic passes through the app's VPN tunnel.