Capture All Traffic from iOS App

Scenario

You need to inspect what your iOS app is sending over the network. RoxyProxy runs on your Mac and your iPhone routes traffic through it over your local Wi-Fi network.

1. Start RoxyProxy on Your Mac

roxyproxy start

Note the network address from the startup output. It will look something like your-mac.local or a local IP such as 192.168.1.42. The proxy listens on port 8080 and the web UI on port 8081.

2. Configure iOS Proxy Settings

On your iPhone:

  • Open Settings > Wi-Fi
  • Tap the (i) next to your connected network
  • Scroll down to Configure Proxy and select Manual
  • Set Server to your-mac.local (or the IP address)
  • Set Port to 8080
  • Tap Save

3. Trust the CA for HTTPS

To decrypt HTTPS traffic, install the RoxyProxy CA certificate on your device:

  • Open Safari on your iPhone and visit http://your-mac.local:8081/api/ca.crt
  • Safari will prompt you to install the configuration profile — tap Allow
  • Go to Settings > General > VPN & Device Management and install the downloaded profile
  • Then go to Settings > General > About > Certificate Trust Settings
  • Enable full trust for the RoxyProxy CA certificate

4. Capture and Filter Traffic

Back on your Mac, tail the live traffic stream:

roxyproxy requests --tail

Open your iOS app and use it normally. All HTTP and HTTPS requests will appear in the TUI in real time. Use filters to narrow down to what matters: 

# Filter to your API host
roxyproxy requests --tail --host api.yourapp.com

# Filter to failed requests only
roxyproxy requests --tail --failed

5. Cleanup

When you are done, remove the proxy configuration and CA profile from your device:

  • Go to Settings > Wi-Fi, tap your network, set Configure Proxy back to Off
  • Go to Settings > General > VPN & Device Management and remove the RoxyProxy profile
  • Go to Settings > General > About > Certificate Trust Settings and disable trust for the RoxyProxy CA

With Your AI Agent

Your AI Agent Plugin can walk you through the setup and help you filter the captured traffic:

You: "Help me capture HTTPS traffic from my iOS app"

Your agent walks you through the setup steps and helps filter
the captured traffic once requests start flowing.

Once traffic is flowing, ask your agent to inspect specific requests or diagnose issues directly from the captured data.

← Trace 422 Errors