Skip to content

First run

Proxymate ships with a 5-step onboarding wizard. Takes about 30 seconds.

1. Choose a profile

Five curated starting points, each a pre-built bundle of rules, privacy settings, and AI policy:

  • Developer — minimal WAF, AI agents allowed, privacy headers normalized
  • Privacy — aggressive tracker blocking, cookie filtering, DNT + GPC injected
  • Security — paranoid WAF, C2/beaconing enabled, cert-pinned apps auto-excluded
  • Casual — Steven Black ad/tracker list + HTTPS-everywhere nudge
  • Custom — opt-in to every rule pack manually

You can switch profiles anytime; rules are additive layers, not exclusive modes.

2. Install the root CA

Required for MITM. Skip if you only need plain proxying + WAF on HTTP.

  • Proxymate generates a local Root CA (Proxymate Root CA) stored encrypted on disk
  • Clicks "Install" → enter admin password once → adds the CA to the system keychain with trustRoot
  • The CA is local to this Mac; it cannot be used by anyone without your user passphrase

See the security model for details on what this actually does and does not mean.

3. Pick an upstream

What sits between Proxymate and the wider internet.

  • Direct — Proxymate forwards to the destination itself. Simplest.
  • Local Squid — bundled caching HTTP proxy on 127.0.0.1:3128. Good if you want disk caching without an external service.
  • Local mitmproxy — bundled sidecar on 127.0.0.1:8080. Required for full MITM with script automation.
  • Custom — any upstream host:port. Works with corporate proxies, Tailscale, Cloudflare Zero Trust, your home VPN.

4. Flip the toggle

Menu bar → Proxymate → Enable. System proxy is configured (admin prompt), listener starts, traffic begins flowing through.

From this point on, every HTTP, HTTPS, and SOCKS request from any app on your Mac passes through Proxymate first.

5. Watch the logs

The Logs tab shows live traffic with:

  • Green — allowed
  • Red — blocked (WAF / blacklist / content match)
  • Yellow — shadowed (would have been blocked, allowed for audit)
  • Blue — AI / agent-detected

Click any row to see full headers, matched rule, response status.

Zero telemetry. Apple-frameworks only. Audited.