NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI
PyPI, #1913 most downloaded on PyPI
An interactive, SSL/TLS-capable intercepting proxy for HTTP/1, HTTP/2, and WebSockets.
Latest stable
12.3.1
Last release 27 days ago
25 Oct 2026
Release timing varies
gaps range from 2 weeks to 5 months
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
15 years old
90 releases · first in 2012
Drag across the ruler to compare, or tap a release to open it.
You can find the latest release packages at https://mitmproxy.org/downloads/.
Changes: See CHANGELOG.md.
You can find the latest release packages at https://mitmproxy.org/downloads/.
--emudhra or --emudhra-old is enabled.
(#8516, @LiHuan02)set_all().
(#8521, @hakarrr)%s placeholders and never formatted
(BiDi attribute lookup and unsupported option types in OptManager.make_parser).
(#8509, @Pharex38)Your coding agent can read these notes before it upgrades. Set up the MCP server →
You can find the latest release packages at https://mitmproxy.org/downloads/ .
Changes: See CHANGELOG.md.
You can find the latest release packages at https://mitmproxy.org/downloads/.
--emudhra and --emudhra-old options to sign TLS certificates with a compromised eMudhra intermediate CA key.
(#8500, #8503, @mhils)KeyError on tags that are missing from the code page,
instead of showing them as UNKNOWN_TAG_XX.
(#8495, @kayaal34)Set-Cookie attribute parsing: prevent subsequent attributes (such as Secure or HttpOnly) from being swallowed into Expires when Expires contains non-date or short values (e.g. Expires=0), and correctly parse RFC 850 dates with full weekday names.
(#8489, @7-Bala)save_stream_file option help, docstrings and examples.
(#8494, @qodelicious)listen_port option being applied to proxy modes that don't
bind a port (e.g. local), which caused a "Cannot spawn multiple servers on
the same address" error when enabling local capture.
(#8471, @WarpFoxHub)typing-extensions dependency from 4.14 to 4.16.0 on Python 3.12, so that mitmproxy
can be installed next to packages that require a newer release (for example pydantic 2.12 and later).
(#8472, @jpcaruana)float addon options in the Options editor.
(#3144)launch_edge() to the Browser addon, so browser.start edge can
launch an isolated, proxy-configured instance of Microsoft Edge, matching
the existing Chrome and Firefox support.
(#8407, @eliahu-frusin)PyparsingDeprecationWarning during command and flow-filter parsing.
(#8344, @Dnsayhey)CONNECT request and Host header sent
to an upstream proxy (--mode upstream), producing a valid [2001:db8::1]:443
authority per RFC 3986 instead of the malformed 2001:db8::1:443.
(#8326, @gaurav0107)componentDidUpdate when the event list or rowHeight actually change.
(#8312, @hexbinoct)msgpack dependency. The msgpack contentview is
implemented in Rust and shipped with mitmproxy_rs since mitmproxy 12.
(#8319, @lukehsiao)is_supported_version now treats such a
version as unsupported instead of raising an unhandled SSL.Error.
(#8294, @gaurav0107)web_theme option (system, dark, or light).
system follows the operating system's color-scheme preference.
(#8317, @sleeyax)view_order_reversed option for live flows. New flows are
now placed at the top of the table when the option is set, instead of always
being appended at the bottom.
(#8288, @hexbinoct)FlowTable by only recomputing the virtual-scroll window in componentDidUpdate when flowView or rowHeight actually change.
(#8233, @ariel42)image/vnd.microsoft.icon favicons not rendering in the response tab.
(#8232, @ariel42)You can find the latest release packages at https://mitmproxy.org/downloads/.
Changes: See CHANGELOG.md.
You can find the latest release packages at https://mitmproxy.org/downloads/.
notBefore backdate remains below Chromium's 200-day limit.
(#8203, @emanuele-em)authority and subject key identifier mismatch errors when mitmproxy
is configured with a custom CA whose SubjectKeyIdentifier was not derived
as SHA-1 of the public key.
(#8214, @unique-jakub)IndexError in is_mostly_bin when exporting flows to HAR with payloads
that have a UTF-8 continuation byte at the 100-byte cutoff.
(#8196, @juliosuas)You can find the latest release packages at https://mitmproxy.org/downloads/.
Changes: See CHANGELOG.md.
You can find the latest release packages at https://mitmproxy.org/downloads/.
CERT_EXPIRY to 199 days.
(#8142, @opstic)message.content.
(#8055, @Prinzhorn)--options output.
(#4423, @emanuele-em)view.settings.setval.toggle command to correctly use the provided key parameter instead of hardcoded "key" string.
(#8167, @nameearly)HTTP://).
(#8174, @emanuele-em)modify_body crash when replacement strings contain backslash sequences.
(#8046, @HueCodes)You can find the latest release packages at https://mitmproxy.org/downloads/.
Changes: See CHANGELOG.md.
You can find the latest release packages at https://mitmproxy.org/downloads/.
tcp_timeout option (default: 600 seconds).
Previously, the timeout was hardcoded to 10 minutes for all TCP connections.
(#7909, @keshavkrishnadav)bless from hex editors to avoid issues with macOS
(#7937, @caiquejjx)is_mostly_bin check to support chinese characters
(#7933, @caiquejjx, @mhils)@ts-expect-error directives.
(#7988, @DNEGEL3125)You can find the latest release packages at https://mitmproxy.org/downloads/.
Changes: See CHANGELOG.md.
You can find the latest release packages at https://mitmproxy.org/downloads/.
htpasswd file parser with a custom implementation to migrate off unmaintained
passlib dependency. The new parser only supports bcrypt and SHA-1 hashing.
Contributions for additional formats are welcome as long as they don't introduce new
dependencies.
(#7906, @mhils)You can find the latest release packages at https://mitmproxy.org/downloads/.
Changes: See CHANGELOG.md.
You can find the latest release packages at https://mitmproxy.org/downloads/.
web_port option.
(#7827, @sujaldev)windows-2019 runner to windows-2025.
(#7801, @chedieck)You can find the latest release packages at https://mitmproxy.org/downloads/ .
Changes: See CHANGELOG.md.
You can find the latest release packages at https://mitmproxy.org/downloads/.
You can find the latest release packages at https://mitmproxy.org/downloads/.
Changes: See CHANGELOG.md.
You can find the latest release packages at https://mitmproxy.org/downloads/.
You can find the latest release packages at https://mitmproxy.org/downloads/.
Changes: See CHANGELOG.md.
You can find the latest release packages at https://mitmproxy.org/downloads/.
You can find the latest release packages at https://mitmproxy.org/downloads/ .
Changes: See CHANGELOG.md.
You can find the latest release packages at https://mitmproxy.org/downloads/.
str with the prettified data.
Syntax highlighting is now signaled off-band (and based on tree-sitter).mitmproxy.dns.Message has been renamed to mitmproxy.dns.DNSMessage
(#7670, @mhils)You can find the latest release packages at https://mitmproxy.org/downloads/ .
Changes: See CHANGELOG.md.
You can find the latest release packages at https://mitmproxy.org/downloads/.
web_password.
(#7554, @mhils)You can find the latest release packages at https://mitmproxy.org/downloads/.
Changes: See CHANGELOG.md.
You can find the latest release packages at https://mitmproxy.org/downloads/.
web_password option replaces the randomly-generated token
authentication with a fixed secret that survives mitmproxy restarts.
(0bd573a, @mhils)xsrf_token cookie is now HttpOnly; SameSite=Strict.
(#7491, @mhils)ignore_hosts or allow_hosts.
(#7519, @mhils)You can find the latest release packages at https://mitmproxy.org/downloads/.
Changes: See CHANGELOG.md.
You can find the latest release packages at https://mitmproxy.org/downloads/.
You can find the latest release packages at https://mitmproxy.org/downloads/.
Changes: See CHANGELOG.md.
You can find the latest release packages at https://mitmproxy.org/downloads/.
validate_inbound_headers is disabled.
(#7361, #7373, @mhils)You can find the latest release packages at https://mitmproxy.org/downloads/.
Changes: See CHANGELOG.md.
You can find the latest release packages at https://mitmproxy.org/downloads/.
tun proxy mode that creates a virtual network device on Linux for transparent proxying.
(#7278, @mhils)browser.start command now supports Firefox.
(#7239, @sujaldev)modify_headers and stream_large_bodies options.
This may break users of modify_headers that rely on filters referencing the message body.
We expect this to be uncommon, but please make yourself heard if that's not the case.
(#7286, @lukant)protobuf library as it was no longer being used.
(#7327, @matthew16550)You can find the latest release packages at https://mitmproxy.org/downloads/.
Changes: See CHANGELOG.md.
You can find the latest release packages at https://mitmproxy.org/downloads/.
show_ignored_hosts option to display ignored flows in the UI.
This option is implemented as a temporary workaround and will be removed in the future.
(#6720, @NicolaiSoeborg)getaddrinfo-based fallback for DNS resolution if we are unable to
determine the operating system's name servers.
(#7122, @mhils)certs option without a matching private key.
(#7073, @mhils)STOP_SENDING QUIC frames.
(#7119, @mhils)Connection.tls_version now is QUICv1 instead of QUIC for QUIC.
(#7201, @mhils)You can find the latest release packages at https://mitmproxy.org/downloads/.
Changes: See CHANGELOG.md.
You can find the latest release packages at https://mitmproxy.org/downloads/.
You can find the latest release packages at https://mitmproxy.org/downloads/.
Changes: See CHANGELOG.md.
You can find the latest release packages at https://mitmproxy.org/downloads/.
You can find the latest release packages at https://mitmproxy.org/downloads/.
Changes: See CHANGELOG.md.
You can find the latest release packages at https://mitmproxy.org/downloads/.
HttpConnectedHook and HttpConnectErrorHook.
(#6930, @errorxyz)allow_hosts.
(#7002, @JarLob, @mhils)typing.Sequence[str] to be an editable option.
(#7001, @errorxyz)You can find the latest release packages at https://mitmproxy.org/downloads/.
Changes: See CHANGELOG.md.
You can find the latest release packages at https://mitmproxy.org/downloads/.
v again.
(#6810, @mhils)-n is passed.
(#6819, @mhils)unbuffered (stdout/stderr) flag for the mitmdump PyInstaller build.
(#6821, @Prinzhorn)You can find the latest release packages at https://mitmproxy.org/downloads/.
Changes: See CHANGELOG.md.
You can find the latest release packages at https://mitmproxy.org/downloads/.
server_connect_error hook that is triggered when connection establishment fails.
(#6806, @haanhvu, @spacewasp, @mhils)client_connected handlers would crash mitmproxy.
(#6749, @mhils)You can find the latest release packages at https://mitmproxy.org/downloads/.
Changes: See CHANGELOG.md.
You can find the latest release packages at https://mitmproxy.org/downloads/.
You can find the latest release packages at https://mitmproxy.org/downloads/.
Changes: See CHANGELOG.md.
You can find the latest release packages at https://mitmproxy.org/downloads/.
allow_hosts/ignore_hosts would break with IPv6 connections.
(#6614, @dqxpb)ca_file.
(#6666, @manselmi)content_view_lines_cutoff option to mitmdump
(#6692, @errorxyz)You can find the latest release packages at https://mitmproxy.org/downloads/.
Changes: See CHANGELOG.md.
You can find the latest release packages at https://mitmproxy.org/downloads/.
allow_hosts/ignore_hosts option now matches against the full host:port string.
(#6594, @LouisAsanaka)You can find the latest release packages at https://mitmproxy.org/downloads/.
Changes: See CHANGELOG.md.
You can find the latest release packages at https://mitmproxy.org/downloads/.
You can find the latest release packages at https://mitmproxy.org/downloads/.
Changes: See CHANGELOG.md.
You can find the latest release packages at https://mitmproxy.org/downloads/.
mitmproxy_rs.
This represents a major API change as UDP traffic is now exposed as streams
instead of a callback for each packet. (@mhils)ignore_hosts would terminate requests
instead of forwarding them.
(#6559, @mhils)ignore_hosts now waits for the entire HTTP headers if it suspects the connection to be HTTP.
(#6559, @mhils)You can find the latest release packages at https://mitmproxy.org/downloads/.
Changes: See CHANGELOG.md.
You can find the latest release packages at https://mitmproxy.org/downloads/.
content-length headers
(#6548, @zanieb)allow_hosts/ignore_hosts options in WireGuard mode (#5930).
(#6513, @dsphper)ignore_hosts in WireGuard Mode.
(#6513, @dsphper)ignore_hosts now also takes HTTP/1 host headers into account.
(#6513, @dsphper)Key= instead of Key
(#5084, @Speedlulu)mitmweb splitter becoming drag and drop.
(#6492, @xBZZZZ)cryptography.x509.GeneralNames instead of list[str]
across the codebase. This fixes a regression introduced in mitmproxy 10.1.1 related to punycode domain encoding.
(#6537, @mhils)You can find the latest release packages at https://mitmproxy.org/downloads/.
Changes: See CHANGELOG.md.
You can find the latest release packages at https://mitmproxy.org/downloads/.
replay-extra from CLI status bar.
(37d62ce, @mhils)You can find the latest release packages at https://mitmproxy.org/downloads/.
Changes: See CHANGELOG.md.
You can find the latest release packages at https://mitmproxy.org/downloads/.
server_replay_extra option to serverplayback to define behaviour
when replayable response is missing.
(#6465, @dkarandikar)You can find the latest release packages at https://mitmproxy.org/downloads/.
Changes: See CHANGELOG.md.
You can find the latest release packages at https://mitmproxy.org/downloads/.
You can find the latest release packages at https://mitmproxy.org/downloads/.
Changes: See CHANGELOG.md.
You can find the latest release packages at https://mitmproxy.org/downloads/.
You can find the latest release packages at https://mitmproxy.org/downloads/.
Changes: See CHANGELOG.md.
You can find the latest release packages at https://mitmproxy.org/downloads/.
You can find the latest release packages at https://mitmproxy.org/downloads/.
Changes: See CHANGELOG.md.
You can find the latest release packages at https://mitmproxy.org/downloads/.
Add support for reading HAR files using the existing flow loading APIs, e.g. mitmproxy -r example.har.
(#6335, @stanleygvi)
Add support for writing HAR files using the save.har command and the hardump option for mitmdump.
(#6368, @stanleygvi)
Packaging changes:
mitmproxy-rs does not depend on a protobuf compiler being available anymore,
we're now also providing a working source distribution for all platforms.mitmproxy-rs now depends on mitmproxy-macos. We only provide binary wheels for this package because
it contains a code-signed system extension. Building from source requires a valid Apple Developer Id, see CI for
details.mitmproxy-rs now depends on mitmproxy-windows. We only provide binary wheels for this package to
simplify our deployment process, see CI for how to build from source.(#6303, @mhils)
Increase maximum dump file size accepted by mitmweb (#6373, @t-wy)
You can find the latest release packages at https://mitmproxy.org/downloads/.
Changes: See CHANGELOG.md.
You can find the latest release packages at https://mitmproxy.org/downloads/.
replay.server.add command for adding flows to server replay buffer
(#5851, @italankin)Request.port now also updates the Host header if present.
This aligns with Request.host, which already does this.
(#5908, @sujaldev)esc key can now be used to exit the current view
(#6087, @sujaldev)server_replay_nopop option has been renamed to server_replay_reuse to avoid confusing double-negation.
(#6084, @prady0t, @Semnodime)ssl_insecure flag is set.
(#6281, @DurandA)onboarding_port option has been removed. The onboarding app now responds
to all requests for the hostname specified in onboarding_host.connection.Client and connection.Server now accept keyword arguments only.
This is a breaking change for custom addons that use these classes directly.You can find the latest release packages at https://mitmproxy.org/downloads/.
Changes: See CHANGELOG.md.
You can find the latest release packages at https://mitmproxy.org/downloads/.
You can find the latest release packages at https://mitmproxy.org/downloads/.
Changes: See CHANGELOG.md.
You can find the latest release packages at https://mitmproxy.org/downloads/.
add_log event hook. Users should use the builtin logging module instead.
See the docs for details and upgrade instructions.
(#5590, @mhils)mitmproxy.ctx.log in favor of Python's builtin logging module.
See the docs for details and upgrade instructions.
(#5590, @mhils)mode option is now a list of server specs instead of a single spec.
The CLI interface is unaffected, but users may need to update their config.yaml.
(#5393, @mhils)connection_strategy to lazy now also disables early
upstream connections to fetch TLS certificate details.
(#5487, @mhils)tls_version_server_min and tls_version_server_max options.
(#5546, @mhils)content_view_lines_cutoff.
(#5548, @sanlengjingvv)Changes: See CHANGELOG.md. You can find the latest release packages at https://mitmproxy.org/downloads/.
Changes: See CHANGELOG.md. You can find the latest release packages at https://mitmproxy.org/downloads/.
Changes: See CHANGELOG.md. You can find the latest release packages at https://mitmproxy.org/downloads/.
Changes: See CHANGELOG.md. You can find the latest release packages at https://mitmproxy.org/downloads/.
mailcap module.
(#5297, @KORraNpl)Check out our release announcement blog post! 🎉
Check out our release announcement blog post! 🎉
You can find the latest release packages at https://mitmproxy.org/downloads/.
tls_{established,failed}_{client,server} event hooks
to record negotiation success/failure (@mhils, #4790)client_replay_concurrency option, which allows more than one client replay request to be in-flight at a time. (@rbdixon)view.flows.resolve (#4916, @rbdixon)running() is invoked twice on startup (#3584, @mhils)n new flow keybind to mitmweb (#5061, @ianklatzco)WebSocketMessage.injected flag (@Prinzhorn)Flow.live, which signals if a flow belongs to a currently active connection. (#4207, @mhils)--set options (#5067, @marwinxxii)Do not add a Content-Length header for chunked HTTP/1 messages (@matthewhughes934)
You can find the latest release packages at https://mitmproxy.org/downloads/.
CVE-2021-39214: Fix request smuggling vulnerabilities reported by @chinchila
You can find the latest release packages at https://mitmproxy.org/downloads/.
Fix a WebSocket crash introduced in 7.0.1 (@mhils)
You can find the latest release packages at https://mitmproxy.org/downloads/.
Performance: Re-use OpenSSL contexts to enable TLS session resumption (@mhils)
Server.address (@SaladDais)You can find the latest release packages at https://mitmproxy.org/downloads/.
Check out our release announcement blog post! 🎉
Check out our release announcement blog post! 🎉
You can find the latest release packages at https://mitmproxy.org/downloads/.
Mitmproxy has a completely new proxy core, fixing many longstanding issues:
clientconnect, clientdisconnect, serverconnect, serverdisconnect, and log
events have been replaced with new events, see addon documentation for details (@mhils)render_priority instead of should_render, allowing more specialization (@mhils)+json suffix in content type (@kam800)http2_priority, relax_http_form_validation, upstream_bind_address,
spoof_source_address, and stream_websockets. If you depended on one of them please let us know.
mitmproxy never phones home, which means we don't know how prominently these options were used. (@mhils)? now exits console help view (@abitrolly)--modify-headers now works correctly when modifying a header that is also part of the filter expression (@Prinzhorn)export_preserve_original_ip to force exported command to connect to IP from original request.
Only supports curl at the moment. (@dkasak)browser.start command may be executed more than once to start additional
browser sessions. (@rbdixon)flow.mark command may be used to mark a flow with either the default
"red ball" marker, a single character, or an emoji like :grapes:. Use the ~marker filter to filter on marker
characters. (@rbdixon)flow.comment command to add a comment to the flow. Add ~comment <regex> filter syntax to search flow comments.
(@rbdixon)boundary values on edit. (@roytu)Transfer-Encoding: chunked HTTP message bodies are now retained if they are below the stream_large_bodies limit.
(@mhils)json() method for HTTP Request and Response instances will return decoded JSON body. (@rbdixon)This release fixes another bug in mitmweb's serialization process. All other tools are unaffected.
This release fixes another bug in mitmweb's serialization process. All other tools are unaffected.
You can find the latest release packages at https://mitmproxy.org/downloads/.
This release fixes a bug in mitmweb's serialization process. All other tools are unaffected.
This release fixes a bug in mitmweb's serialization process. All other tools are unaffected.
You can find the latest release packages at https://mitmproxy.org/downloads/.
Check out our release announcement blog post! 🎉 🔗
Check out our release announcement blog post! 🎉 🔗
You can find the latest release packages at https://mitmproxy.org/downloads/.
Check out our release announcement blog post! 🎉 🔗
Check out our release announcement blog post! 🎉 🔗
@charset to decode CSS files if available (@prinzhorn)console_strip_trailing_newlines, and no longer strip trailing newlines by default (@capt8bit)deflateRaw for Content-Encoding's (@kjoconnor)You can find the latest release packages at https://mitmproxy.org/downloads/.
Check out our release announcement blog post! 🎉 🔗
Check out our release announcement blog post! 🎉 🔗
You can find the latest release packages at https://mitmproxy.org/downloads/.
Fixed Docker images not starting due to missing shell
Reduce leaf certificate validity to one year due to upcoming browser changes (@mhils)
Major Changes
Full Changelog
You can find the latest release packages at https://mitmproxy.org/downloads/.
Fixed precompiled Linux binaries to not crash in table mode.
You can find the latest release packages on https://mitmproxy.org/downloads/.
Security: Fixed command injection vulnerabilities when exporting flows as curl/httpie commands (@cript0nauta)
You can find the latest release packages on https://mitmproxy.org/downloads/.
config.yml or config.yaml (@ylmrx)view.focus.[next|prev] (@ylmrx)pfctl on MacOS. (@tomlabaude)--allow-hosts option (@pierlon)Security: Protect mitmweb against DNS rebinding. (CVE-2018-14505, @atx)
You can find the latest release packages on https://mitmproxy.org/downloads/.
Add support for IPv6 transparent mode on Windows
You can find the latest release packages on our snapshot server.
The previous release had a packaging issue, so we bumped it to v4.0.1 and re-released it. This contains no actual bugfixes or new features.
The previous release had a packaging issue, so we bumped it to v4.0.1 and re-released it. This contains no actual bugfixes or new features.
Please see the v4.0.0 release notes!
mitmproxy now requires Python 3.6!
SO_KEEPALIVE (#3076)config.yaml under the configuration directory).allow_remote got replaced by block_global and block_private (#3100)cadir option has been renamed to confdirctx.log.info explicitly.~ in paths during the cut command (#3078)Fix an issue that caused mitmproxy to not retry HTTP requests on timeout.
A minor release that actually includes the fix meant for 3.0.2.
A minor release that actually includes the fix meant for 3.0.2.
One column per quarter.