Getting started

ProxyHawk runs a local HTTP proxy on your Mac. Point clients at it to record traffic.

Launch & port

When the app starts successfully, the core listens on port 9090 by default (http://127.0.0.1:9090 / your LAN IP :9090 from other devices).

Checklist: Ensure ProxyHawk is running before you expect to see traffic. The status UI should show the proxy as active.

Point clients at the proxy

Typical setups:

macOS system proxy (optional)

ProxyHawk can toggle Web (HTTP) and Secure Web (HTTPS) proxy settings so Safari and other system‑proxy‑aware apps use 127.0.0.1:9090. This uses a privileged helper and may require approval under System Settings → General → Login Items & Extensions.

Security note: System proxy affects which apps send traffic through ProxyHawk. Turn it off when you are done debugging, especially on shared machines.

Next steps

  1. Install the CA and configure SSL proxying for HTTPS.
  2. Use the traffic list — pins, filters, copy as cURL.
  3. Open the API Client to replay or edit requests.