mitmproxy
mitmproxy.org
- Free plan
- Open source
- Windows
- macOS
- Linux
- Web
- API
- Self-hosted
What mitmproxy is
mitmproxy is a free set of tools for intercepting and working with HTTP/1, HTTP/2, WebSocket and SSL/TLS traffic through a proxy. It can pause HTTP and HTTPS requests or responses for editing, save conversations for later analysis, and replay client requests or recorded server responses. Choose mitmproxy for an interactive console, mitmweb for a browser-based GUI, or mitmdump for non-interactive terminal output. Proxy modes include regular, local capture, WireGuard, reverse, transparent, TUN, upstream, SOCKS5 and DNS. Python addons can react to events, change proxy behavior and expose commands. WireGuard mode can capture traffic from external devices or individual Android apps. The tool includes a certificate authority that generates interception certificates as needed. Installation is documented for Windows, macOS and Linux, with PyPI and official Docker images also available. The documentation says HTTP/3 client replay is currently broken. Dependencies in precompiled binaries and Docker images are fixed at release, so the project recommends regular updates.
Who it suits
mitmproxy suits developers and operators who need to inspect, edit, record or replay proxied web traffic. Its console, browser interface and terminal output provide different ways to work with captures.
Good to know, and what to watch
- Edits intercepted HTTP and HTTPS requests and responses.
- Saves conversations and replays requests or server responses.
- Offers console, browser-based and terminal interfaces.
- Python addons can change behavior and expose commands.
- WireGuard mode can capture external device traffic.
- HTTP/3 client replay is currently broken.
- Bundled binary and Docker dependencies cannot be updated in place.
Plans
Every plan and priceFree
mitmproxy
Free plan
Getting started
- Open the mitmproxy website and choose an installation route
- Install on Windows, macOS, or Linux, or use PyPI or the official Docker image
- Choose mitmproxy, mitmweb, or mitmdump as the interface
- Select a proxy mode such as regular, WireGuard, reverse, or transparent
- Configure the certificate authority for intercepted HTTPS traffic
Limits to check
HTTP/3 client replay is currently broken, and HTTP/3 support has been extensively tested only with cURL. Dependencies in precompiled binaries and Docker images are frozen at release and cannot be updated in place.
The Club's review
mitmproxy is a free, open-source toolkit for intercepting and changing HTTP, HTTPS, and WebSocket traffic. It is best suited to developers, security practitioners, and technical teams that need to inspect real exchanges rather than simply route traffic. Its broad interface and proxy-mode selection make it adaptable, while protocol and binary-maintenance limits matter for production workflows.
It is a strong choice for debugging, testing, and traffic analysis when you can manage proxy configuration and certificate interception. Readers seeking a conventional proxy service or a managed security platform should look elsewhere.
Overview
mitmproxy exposes HTTP/1, HTTP/2, and WebSocket conversations, including SSL/TLS traffic, as they pass through a proxy. Requests and responses can be changed in transit, allowing a developer to test altered headers, payloads, or server behavior without changing the original client or service. Its certificate-authority implementation creates interception certificates on demand, so HTTPS inspection is practical but requires users to deal with trust and certificate setup.
The project offers three ways to work: mitmproxy is an interactive console, mitmweb provides a browser-based graphical interface, and mitmdump emits non-interactive terminal output. This range makes the same toolkit workable for exploratory sessions, browser-oriented review, and scripted or headless jobs.
For category comparisons, see Web Debugging Proxies, Forward Proxy Software, and Proxy Software.
Key features
Inspect, edit, and selectively pause
Requests and responses can be intercepted and modified while in transit. Breakpoint rules let you pause only the exchanges that need attention instead of stopping every request. Response mocking is useful when a test needs a controlled server answer, and WebSocket inspection extends visibility to persistent, bidirectional sessions.
Record and replay
mitmproxy saves HTTP conversations for later analysis and can replay client requests or previously recorded server responses. That supports repeatable debugging and regression work: a team can revisit a captured interaction without reproducing the original conditions each time. HTTP/3 client replay is currently broken, so workflows that depend on replaying that protocol need another approach; HTTP/3 support has been extensively tested only with cURL.
Modes and automation
Regular, local-capture, WireGuard, reverse, transparent, TUN, upstream, SOCKS5, and DNS modes cover substantially different network layouts. WireGuard mode can capture traffic from external devices or individual Android apps, which is valuable for mobile troubleshooting. Python addons can react to events, alter proxy behavior, and expose commands for users, giving teams a route from manual inspection to repeatable automation.
Deployment and operational behavior
Installation guidance covers Windows, macOS, and Linux, with PyPI packages and official Docker images also available. The project says it does not phone home or perform update checks. Precompiled binaries and Docker images freeze their dependencies at release, however, and those dependencies cannot be updated in place; regular updates are recommended. That is a maintenance consideration for environments with strict vulnerability-management requirements.
Pricing
mitmproxy is free and open source. The mitmproxy plan costs nothing and includes the interactive HTTPS proxy, request and response editing, breakpoint rules, traffic replay, response mocking, WebSocket inspection, and proxy chaining. There are no paid tiers, seat charges, usage quotas, trial periods, or renewal terms stated for this plan. It is therefore a straightforward fit for individuals, development teams, and organizations prepared to run and maintain the software themselves.
Platforms
mitmproxy supports Linux, macOS, Windows, self-hosted deployments, and web access through mitmweb. The documented installers, PyPI option, and Docker images give administrators several deployment paths. WireGuard capture also makes it practical to inspect traffic originating on external devices and selected Android applications.
Who it's for
Choose mitmproxy when you need to see and alter live web traffic, capture conversations for later replay, or build custom proxy behavior in Python. It suits software developers debugging clients and APIs, testers creating controlled responses, and security or network engineers analyzing encrypted sessions. The console, web interface, and terminal output accommodate different working styles.
It is a poor fit for readers who want a managed proxy network, a consumer privacy service, or a turnkey security product with vendor-operated policy and support. You must be comfortable configuring interception, trusting generated certificates, and maintaining installed binaries or images. HTTP/3 replay requirements are another reason to consider a different tool.
Pros and cons
Pros
- Deep traffic control: edit requests and responses, set breakpoints, mock responses, and inspect WebSockets in one free toolkit.
- Flexible access: console, browser GUI, and non-interactive output serve interactive and automated workflows.
- Broad proxy coverage: multiple modes, including WireGuard, reverse, transparent, TUN, SOCKS5, and DNS, fit varied network topologies.
- Extensible automation: Python addons can change behavior and expose custom commands.
- No update telemetry: the project says it does not phone home or check for updates.
Cons
- HTTP/3 replay is broken: replay-heavy HTTP/3 workflows cannot rely on the built-in client replay path.
- Frozen release dependencies: precompiled binaries and Docker images cannot update dependencies in place, increasing maintenance work.
- Technical setup required: certificate interception and the many proxy modes demand networking expertise.
Alternatives
Check Point Harmony SASE is the better direction for a paid, managed security platform with Android, iOS, desktop, and web coverage; it offers a 30-day free trial before a required license.
Cato Client suits organizations buying a commercial, multi-year service through Cato or a reseller rather than running an open-source proxy.
Cisco Secure Access is aimed at subscription deployments with tiered pricing based on covered users and term.
Cloudflare Gateway fits teams wanting a hosted freemium gateway, including a free tier for 50 users with up to 24 hours of standard log retention.
Privoxy is a free, self-hosted proxy alternative for users who do not need mitmproxy's interception and replay toolkit.
Squid is another free self-hosted option, with third-party commercial support potentially available.
Apache Traffic Server is a free Linux and self-hosted choice when a traffic-server deployment is the priority.
LatentSync is a free Linux and self-hosted project, but serves a different purpose.
Verdict
mitmproxy is the right choice for technical users who need free, programmable control over HTTP, HTTPS, and WebSocket conversations, especially when editing, replay, and multiple capture modes matter. Look elsewhere if you require reliable HTTP/3 replay, in-place dependency updates for shipped binaries or images, or a managed proxy and security service.
The verdict
mitmproxy provides several interfaces and proxy modes for examining and changing traffic. Keep its HTTP/3 replay limitation and fixed release dependencies in mind when planning a workflow.
Questions people ask
How much does mitmproxy cost?
The mitmproxy plan is free at no cost, and the project is free and open source.
Which operating systems and deployment options are supported?
Installation is documented for Windows, macOS, and Linux. PyPI installation, official Docker images, and self-hosted use are also available.
Can mitmproxy inspect WebSocket and HTTPS traffic?
Yes. It intercepts HTTP/1, HTTP/2, WebSocket, and SSL/TLS traffic, including HTTP and HTTPS requests and responses.
Can it capture traffic from Android apps?
Yes. WireGuard mode can capture traffic from external devices or individual Android apps.
How is the tool extended?
Python addons can respond to events, change proxy behavior, and expose commands for users to invoke.
What the maker publishes
- Addon options
- Third-party addons can define typed options that work through the shared configuration file and interactive editors. source
- Authentication replay limit
- Sticky authentication supports HTTP Basic replay, while HTTP Digest replay is not supported. source
- Binary maintenance risk
- Bundled binary dependencies are frozen per release and are not updated in place, so users are told to update regularly. source
- Binary security limit
- Dependencies in precompiled binaries and Docker images are frozen at release and cannot be updated in place; the documentation recommends updating regularly. source
- Certificate handling
- Mitmproxy includes a certificate authority implementation that generates interception certificates on the fly. source
- Company founders
- The project identifies Aldo Cortesi as founder and lists Maximilian Hils and Thomas Kriechbaumer among core developers. source
- Customization
- Python addons can respond to events to change proxy behavior, and can expose commands for users to invoke. source
- Documentation
- The documentation includes tutorials, concepts, installation guidance, feature references, options and addon examples. source
- Ecosystem
- The official site highlights community addons, mitmproxy2swagger for OpenAPI conversion and kubetap for Kubernetes service proxying. source
- Independent review availability
- A 2026 HTTP debugging comparison reports no comparable mainstream product-review sample for mitmproxy and therefore adds no review-based satisfaction claim. source
- Independent review score
- Legit.Show reports a public-surface production-readiness score of 68 out of 100 measured on 2026-10-08. source
- Installation
- The project documents installation on Windows, macOS, and Linux, and also offers PyPI installation and official Docker images. source
- Installation
- Official installation paths cover macOS Homebrew, Linux binaries, Windows installers, PyPI, WSL and Docker images. source
- Interfaces
- The project provides mitmproxy, an interactive console interface; mitmweb, a browser-based GUI; and mitmdump, non-interactive terminal output. source
- Interfaces
- The project provides a terminal interface called mitmproxy, a headless command-line tool called mitmdump and a browser interface called mitmweb. source
- Licence
- The repository code is released under the permissive MIT licence. source
- Limit: certificate pinning
- Independent reviews report that applications using certificate pinning reject the proxy certificate and require separate bypass work such as instrumentation or repackaging. source
- Limit: large bodies
- Official documentation warns that enabling streaming removes body visibility and prevents body modifications. source
- Limit: mobile trust changes
- An independent review notes that modern Android and iOS apps may ignore user-installed CAs, requiring debugging changes, instrumentation or rooted/jailbroken devices. source
- Limit: setup learning curve
- An independent review says the README omits invocation and certificate setup examples, leaving newcomers to consult the deeper documentation. source
- Mobile traffic
- WireGuard mode can capture traffic from external devices or individual Android apps. source
- Praise: programmability
- An independent review highlights the Python addon API for rewriting requests, logging traffic and automating security tests. source
- Praise: protocol coverage
- An independent review credits mitmproxy with HTTP/1, HTTP/2, HTTP/3, WebSocket and TLS interception support. source
- Praise: three front ends
- An independent technical review praises the combination of console, command-line and web interfaces for serving interactive, automated and graphical workflows. source
Checked against the maker's pages on 15 Oct 2026.