Passthrough Proxy

Pro feature. Passthrough Proxy requires a Pro or Teams license.

The Passthrough Proxy lets you intercept, inspect, and optionally modify live HTTP traffic from any client on your machine — a browser, a mobile simulator, another app, or Restroom itself.

Starting the proxy

Open the Proxy screen. Set the port (default 8899) and click Start. The proxy listens on 127.0.0.1.

Configuring your client

Point your HTTP client at the proxy. For system-wide traffic on macOS:

1. Go to System Settings → Network → (your connection) → Proxies
2. Enable Web Proxy (HTTP) and Secure Web Proxy (HTTPS)
3. Set server to 127.0.0.1 and port to your proxy port

For browser traffic, use a browser extension like SwitchyOmega to route requests through the proxy without affecting system traffic.

Inspecting traffic

Every proxied request appears in the traffic log with method, URL, status, and response time. Click any entry to inspect:

• Full request headers and body
• Full response headers and body
• Timing breakdown

HTTPS inspection

To inspect HTTPS traffic, Restroom generates a local CA certificate. Install it in your system keychain and trust it for SSL:

1. Click Export CA Certificate in the proxy settings
2. Double-click the exported .pem file to add it to your keychain
3. Open Keychain Access, find the certificate, and mark it as Always Trust

This is a local, self-signed certificate that only affects traffic routed through Restroom's proxy.

Filtering

Use the search bar to filter the traffic log by URL. The method and status filters work the same way as in the History screen.