# Android

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

This guide covers how to set up and use Evomi proxies on Android devices. Since Evomi proxies require username/password authentication and Android's built-in proxy settings do not support this, a dedicated proxy client app is required.

## Prerequisites

- An active Evomi proxy subscription
- Your Evomi proxy credentials (username and password)
- An Android device running Android 5.0 or later

## Method 1: Using Postern (Recommended)

[Postern](https://play.google.com/store/apps/details?id=com.puxin.postern) is a proxy client available on the Google Play Store that supports HTTP, HTTPS, SOCKS5, and Shadowsocks. It routes traffic system-wide through a local VPN service and allows per-app routing rules.

### Setup Steps

1. Install **Postern** from the Google Play Store.
2. Open Postern and tap **Add Proxy Server**.
3. Configure the proxy:
   - **Proxy Name**: Enter a label (e.g., `Evomi Residential`)
   - **Proxy Type**: Select `SOCKS5` (or `HTTP/HTTPS` depending on your needs)
   - **Host**: `rp.evomi.com`
   - **Port**: `1002` for SOCKS5 (or `1000` for HTTP)
   - **Username**: Your Evomi username
   - **Password**: Your Evomi password, e.g. `your_password_session-anychars_mode-speed`
4. Tap **Save** to store the profile.
5. Back on the main screen, tap **Add Rule** to create a routing rule:
   - **Rule Name**: e.g. `Route All`
   - **Match Pattern**: Select **All** to route all traffic
   - **Action**: Select your Evomi proxy
6. Enable the VPN connection by tapping the **Start** button. Accept the Android VPN permission prompt.
7. Verify your connection by opening a browser and navigating to `https://ip.evomi.com/s`. The displayed IP should be the proxy IP, not your real one.

Postern lets you create multiple proxy profiles and rules. You can route specific apps through the proxy while others use a direct connection.

## Method 2: Using Drony

[Drony](https://play.google.com/store/apps/details?id=org.sandroproxy.drony) is a free proxy client that supports HTTP, HTTPS, SOCKS4, and SOCKS5 with per-app filtering. It also uses Android's VPN interface to route traffic without requiring root.

### Setup Steps

1. Install **Drony** from the Google Play Store.
2. Open Drony. You will see the **Log** tab by default.
3. Swipe to the **Settings** tab.
4. Tap **Wi-Fi** (or the name of your current network).
5. Under your network name, configure:
   - **Proxy type**: Select `Manual`
   - **Hostname**: `rp.evomi.com`
   - **Port**: `1000` (HTTP) or `1002` (SOCKS5)
   - **Proxy type**: `HTTP` or `SOCKS5` to match the port
   - **Username**: Your Evomi username
   - **Password**: Your Evomi password, e.g. `your_password_session-anychars_mode-speed`
6. Use the **Filter** tab to control which apps route through the proxy.
   - Default value: Select the default action for apps (e.g., **Direct** for no proxy, or **Local proxy chain** to route through the proxy)
   - Tap individual apps to override the default behavior
7. Go back to the **Log** tab and tap the **ON/OFF** toggle at the bottom to activate. Accept the VPN permission prompt.
8. Verify by visiting `https://ip.evomi.com/s` in your browser.

## Why Not the Built-In Wi-Fi Proxy?

Android has a manual Wi-Fi proxy setting under **Settings** > **Network & internet** > **Wi-Fi**, but it has critical limitations that make it unsuitable for Evomi proxies:

- **No username/password authentication** for HTTP proxies in most Android versions. Since Evomi proxies always require authentication, the connection will fail silently in most apps.
- Settings only apply to the specific Wi-Fi network, not mobile data.
- SOCKS5 support is inconsistent across manufacturers.

The built-in Wi-Fi proxy setting does **not** work reliably with Evomi proxies because it cannot handle authentication. Use a dedicated proxy app (Postern or Drony) 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 a browser and navigate to:

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

The displayed IP address should be the proxy server's IP, not your device's real IP. If you see your own IP, the proxy is not active for that app.

## Tips and Troubleshooting

- **Credentials**: Double-check hostname, port, username, and the full password string (including `_session-` and `_mode-` parameters).
- **App-specific proxy settings**: Some apps (e.g., Firefox) have their own internal proxy settings that may override the VPN-based proxy. Check the app's network settings.
- **Force-stop apps**: If an app does not pick up the new proxy settings, force-stop it from Android Settings and relaunch.
- **Battery usage**: VPN-based proxy apps may increase battery consumption. Disable the proxy when not in use.
- **SOCKS5 recommended**: For system-wide proxying through apps like Postern or Drony, SOCKS5 is generally more reliable than HTTP since it handles all traffic types.
- **Toggle Airplane mode**: If you experience connectivity issues after changing proxy settings, toggling Airplane mode on and off can help reset the network stack.
