Documentation

Go from download to first capture in minutes. This guide covers everything — from one-click setup and physical iPhone capture to Postman exports and advanced debugging tools.

New to ProxyHawk? Start with Getting started, then follow SSL & certificates to enable HTTPS decryption.
01

Getting started

Launch the proxy, connect your iOS Simulator or physical iPhone (one-time setup — no Wi-Fi proxy per session), and start capturing immediately.

TLS

SSL & certificates

Install the ProxyHawk CA to decrypt HTTPS. Covers macOS Keychain, iOS trust settings, Android, SSL proxying modes, and certificate pinning.

LOG

Traffic & filters

Navigate the traffic list, pin important hosts, apply filters, copy as cURL, and export HAR files. Includes the Postman collection export workflow.

API

API Client

Replay captured requests, compose new ones, import cURL, and export Postman collections with auto-generated environment variables — URLs, auth tokens, and headers included.

DEV

Advanced tools

Breakpoints to pause and edit live traffic, block rules, Map Local / Remote for mocking, scripts for automation, and network throttling.

SEC

Security & privacy

CA hygiene, threat model, sensitive data handling, and responsible use of a local MITM proxy.

INF

Limitations

Known constraints — certificate pinning, body size caps, platform sandboxing, and trial behavior.

CI

Guard CI onboarding

Add ProxyHawk Guard after GitHub deploys — existing pipeline or bootstrap PR. Public guide for any laptop.