1. Trust the CA certificate
Every device that goes through this proxy (physical phone, simulator, or emulator) needs to install and trust this certificate once.
Download CA certificate
2. Point your device at the proxy
Set the device's HTTP proxy to this machine's address and the proxy port below (not the web UI port).
Proxy: <this server's host>:<PROXY_PORT>
3. Platform-specific steps
- iOS Simulator: Settings app in the simulator → install the downloaded profile → Settings → General → About → Certificate Trust Settings → enable full trust for the HomeRun Dev Proxy CA.
- iOS physical device: AirDrop or email the .pem to the device, install the profile in Settings, then enable full trust the same way as above.
- Android emulator: push the cert into the emulator's system trust store, or drag-and-drop the .pem onto the emulator window on most recent Android Studio versions.
- Android physical device: Settings → Security → Install a certificate → CA certificate, then select the downloaded .pem. Your app also needs a debug network security config that trusts user-installed certificates.
Full step-by-step instructions with screenshots are in the project README.