Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

mitmproxy

mitmproxy.org

  • Free plan
  • Open source
  • Windows
  • macOS
  • Linux
  • Web
  • API
  • Self-hosted
8.5 Club score Visit mitmproxy.org

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.

Free

Free

mitmproxy

Free

Free plan

Getting started

  1. Open the mitmproxy website and choose an installation route
  2. Install on Windows, macOS, or Linux, or use PyPI or the official Docker image
  3. Choose mitmproxy, mitmweb, or mitmdump as the interface
  4. Select a proxy mode such as regular, WireGuard, reverse, or transparent
  5. 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.