▶ Connect a browser or device
Route any browser — on any OS, device, or network — through MiniProxy so every request it makes is captured in the dashboard and TUI. Works from a phone on your LAN or a laptop anywhere, pointing at this proxy over the internet.
…
checking…
This is the HTTP proxy to enter in your browser/OS settings. It is detected from how you opened this page — if you came in through an SSH tunnel or port-forward, it is already correct. Override below.
One-click — PAC URL (recommended)
Where does the PAC URL go? (per platform)
Chrome / Edge — Settings → System → Open proxy settings → Use setup script → paste the PAC URL.
Firefox — Settings → Network Settings → Automatic proxy configuration URL.
macOS — System Settings → Network → Wi-Fi → Proxies → Automatic Proxy Configuration.
Windows — Settings → Network → Proxy → Use setup script.
Android — Wi-Fi long-press → Modify → Advanced → Proxy: PAC auto-config (per-network).
iOS — Settings → Wi-Fi → (i) → Configure Proxy → Automatic → paste URL.
Manual — host & port (works everywhere, no PAC support needed)
Set an HTTP proxy to … in your browser or OS proxy settings. Firefox-only browsers can set it under Firefox settings; system-wide under network settings.
Chrome on a device you can't reconfigure? Launch it with the proxy baked in:
…
Terminal tools — curl -x and friends
…
…
Any client that honors proxy environment variables (pip, npm, git, requests…) is captured the same way — see docs/integrations.md.
Without this step HTTPS still routes and is captured (method, URL, status), but mitmproxy can't decode the encrypted body. Install mitmproxy's CA once per device to see request/response bodies.
checking for the CA file on the proxy host…
Install the CA (per OS)
macOS — open the .pem → Keychain Access → System → trust "Always Trust" for SSL.
Windows — double-click the .pem → Install Certificate → Local Machine → "Trusted Root Certification Authorities".
Linux (Firefox) — Settings → Privacy & Security → Certificates → Import.
Linux (system) — copy to /usr/local/share/ca-certificates/miniproxy.crt then run sudo update-ca-certificates.
Android — Settings → Security → Install from storage (credential must be user-added; Android 7+ apps may ignore user CAs — use the browser).
iOS — download → Settings → Profile Downloaded → Install → then enable full trust in About → Certificate Trust Settings.
Scan from a phone to open this exact page with the right addresses.
Generates a request from this proxy host through MiniProxy — if it succeeds, capture works end-to-end. After connecting your browser, browse a site and confirm the requests appear in the Live tab.