# mitmproxy

Free, open-source proxy for inspecting, modifying, recording and replaying HTTP/S traffic, with terminal, scripted and browser-based interfaces.

> This is the Markdown version of the mitmproxy page on OpenNavo, with the same facts as the web page: <https://opennavo.com/apps/mitmproxy>

- **Latest version**: `12.3.1`
- **Developer**: mitmproxy project and contributors
- **Homepage**: <https://mitmproxy.org/>
- **Categories**: [Networking](https://opennavo.com/categories/network)
- **Install**: `brew install --cask mitmproxy`
- **30-day installs**: 11,246
- **Homebrew**: Available; updated by Homebrew
- **Download URL**: <https://downloads.mitmproxy.org/12.3.1/mitmproxy-12.3.1-macos-arm64.tar.gz>
- **SHA-256**: `9b7f7a8e3fd1b1544089c937c579ef1f0f503f0ea598c25bda9eab077c735b93`
- **Commands**: mitmdump, mitmproxy, mitmweb

SHA-256 only checks that the download is complete; it is not a security certification.

## Installation and removal contents

```json
[
  {
    "declaration": {
      "binary": [
        "mitmproxy.app/Contents/MacOS/mitmdump"
      ],
      "target": "$HOMEBREW_PREFIX/bin/mitmdump"
    },
    "phase": "install",
    "sources": [
      "mitmproxy.app/Contents/MacOS/mitmdump"
    ],
    "target": "$HOMEBREW_PREFIX/bin/mitmdump",
    "type": "binary"
  },
  {
    "declaration": {
      "binary": [
        "mitmproxy.app/Contents/MacOS/mitmproxy"
      ],
      "target": "$HOMEBREW_PREFIX/bin/mitmproxy"
    },
    "phase": "install",
    "sources": [
      "mitmproxy.app/Contents/MacOS/mitmproxy"
    ],
    "target": "$HOMEBREW_PREFIX/bin/mitmproxy",
    "type": "binary"
  },
  {
    "declaration": {
      "binary": [
        "mitmproxy.app/Contents/MacOS/mitmweb"
      ],
      "target": "$HOMEBREW_PREFIX/bin/mitmweb"
    },
    "phase": "install",
    "sources": [
      "mitmproxy.app/Contents/MacOS/mitmweb"
    ],
    "target": "$HOMEBREW_PREFIX/bin/mitmweb",
    "type": "binary"
  },
  {
    "declaration": {
      "zap": [
        {
          "trash": "~/.mitmproxy"
        }
      ]
    },
    "phase": "cleanup",
    "sources": [],
    "type": "zap"
  }
]
```

## About

mitmproxy is a free, open-source interactive proxy for inspecting, modifying, recording and replaying network traffic. Developers, testers and network engineers can use it to investigate applications and services in environments they control. It includes mitmproxy, a terminal interface; mitmdump, a command-line tool for scripted processing; and mitmweb, a browser-based interface.

### Features
- Inspect HTTP and HTTPS requests and responses, including HTTP/2 and WebSocket traffic.
- Intercept and edit messages, then resume requests to examine application behavior.
- Record traffic flows, filter and annotate them, and replay client or server flows.
- Export traffic for further analysis, including HAR workflows.
- Extend processing with Python addons and configurable options.
- Use supported proxy modes for different network setups; protocol capabilities depend on the chosen mode.

### Installation and first use
Install `brew install --cask mitmproxy`, the official recommended macOS method, or download the architecture-specific standalone archive. The Homebrew cask links mitmproxy, mitmdump and mitmweb executables into Homebrew's bin directory; it is a command-line tool distribution rather than a conventional draggable GUI application. Start mitmproxy in a terminal, or mitmweb for its local browser UI. Configure your test client to use the listening proxy; regular proxy mode ordinarily listens on port8080, and mitmweb uses a separate web interface. Change ports if another local service already uses them.

For HTTPS inspection, the test client must trust the mitmproxy CA generated for your installation. The official certificates guide explains installing trust on each platform. A browser can visit mitm.it through the configured proxy to obtain the appropriate certificate. Certificate pinning or an application-specific trust store can still prevent interception. Return your client proxy and trust settings to the desired state when finished. Recorded traffic and the CA private key in ~/.mitmproxy can contain sensitive material; retain only what you need for your testing workflow.

### Requirements and dependencies
The official standalone binaries include a self-contained Python3 environment, OpenSSL and other dependencies. You do not need to install Python separately for this cask. The version12.2 line's binary environment moved to Python3.14. Addons requiring extra Python packages may need a separate PyPI/uv installation with those packages rather than modifying the frozen standalone bundle. Dependencies inside a binary release cannot be updated independently; update mitmproxy to obtain newer bundled dependencies.

The cask provides macOS Apple Silicon and Intel archives and declares no extra formula dependency. Its listed macOS platforms include Big Sur and newer, but the retrieved upstream installation guide does not give an independent numeric macOS minimum; do not treat a cask platform list as a guarantee for every older OS. Official Linux standalone binaries and Windows installer/binaries are also available. On Windows, the publisher recommends Windows Terminal and also supports WSL. Linux distribution packages are community-maintained and can lag upstream. This catalog's default download is the macOS ARM64 archive. No fixed RAM or disk-space minimum was confirmed; capture volume and stored flows affect resource use. Archive download size is not installed space.

### Conflicts and cleanup
Homebrew declares no named cask conflict. Existing executables with the same names, another proxy on the same port, or client VPN/proxy routing can affect operation. mitmproxy does not automatically capture every process: select and configure a suitable proxy mode for the traffic you want to test. Some TLS failures reflect client trust, pinning or certificate configuration rather than an installation error. Optional Homebrew zap deletes ~/.mitmproxy, including settings, generated CA material and retained files there; back up data you need first.

### Accounts, costs and license
mitmproxy is free software under the MIT license, maintained by the mitmproxy project and contributors. Core local use does not require a paid subscription or hosted-service account. Third-party services you connect to keep their own credentials and charges. The project accepts sponsorship. The official installation documentation states that mitmproxy does not phone home or perform automatic update checks.

### Official references
- [Installation and bundled dependencies](https://docs.mitmproxy.org/stable/overview/installation/)
- [Certificates](https://docs.mitmproxy.org/stable/concepts/certificates/)
- [Official downloads](https://mitmproxy.org/downloads/)
- [Source and MIT license](https://github.com/mitmproxy/mitmproxy/tree/v12.2.3)
- [Version-specific changelog](https://github.com/mitmproxy/mitmproxy/blob/v12.2.3/CHANGELOG.md)

## System requirements

- Build for macOS 27, 26, 15, 14, 13, 12, 11 · Version: 12.3.1 · Intel · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/m/mitmproxy.rb> · Checked 2026-11-21
  - <https://downloads.mitmproxy.org/12.3.1/mitmproxy-12.3.1-macos-x86_64.tar.gz>
  - SHA-256: `f4cf5e563e7068af297a27be97686f58917760d3c0dcc6a997ca83f6f5ffb3db`
- Build for macOS 27, 26, 15, 14, 13, 12, 11 · Version: 12.3.1 · Apple silicon · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/m/mitmproxy.rb> · Checked 2026-11-21
  - <https://downloads.mitmproxy.org/12.3.1/mitmproxy-12.3.1-macos-arm64.tar.gz>
  - SHA-256: `9b7f7a8e3fd1b1544089c937c579ef1f0f503f0ea598c25bda9eab077c735b93`

## mitmproxy security facts

Only facts that can be checked, each with its source and date. This is not a safety certification. To check the files you downloaded, scan them on your Mac with OpenNavo.

- <https://github.com/mitmproxy/mitmproxy> · Open source: Yes — <https://github.com/mitmproxy/mitmproxy> · Checked 2026-11-13

## Uninstall

- `brew uninstall --cask mitmproxy`

A regular uninstall removes the app and keeps its settings and caches.

### Deep clean (optional)

- `brew uninstall --zap --cask mitmproxy`

`--zap` also deletes the settings, caches and other files listed in the Homebrew definition. They can include data shared with other apps and cannot be restored, and it does not guarantee that nothing is left. Back up any data you need first. To keep settings and caches, leave out `--zap`.

A regular uninstall removes the app and keeps its settings and caches.

- Files and folders: `~/.mitmproxy` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/m/mitmproxy.rb> · These entries come from the Homebrew definition, checked 2026-11-21. They say what it declares, not what is on your Mac.

## Latest release notes

### 12.3.1 (2026-10-25)

mitmproxy 12.3.1 was released on October 25, 2026. This update requires Brotli 1.2.1 for a decoder security fix, adds Python 3.15 support and fixes cookie and error-message handling.

mitmproxy 12.3.1 was released on October 25, 2026. This update requires Brotli 1.2.1 for a decoder security fix, adds Python 3.15 support and fixes cookie and error-message handling.

**Security**
- Requires Brotli 1.2.1 to include the upstream decoder fix for CVE-2026-111497.
- Blocks OCSP and CRL requests to eMudhra and Sectigo revocation hosts when `--emudhra` or `--emudhra-old` is enabled.

**Added**
- mitmproxy now supports Python 3.15. Binary releases ship with 3.15 by default.

**Fixed**
- Preserves caller-provided value lists when replacing query parameters or cookies with `set_all()`.
- Refreshes cookie expiration dates for empty-valued cookies during server replay.
- Fixes two error messages that were built with `%s` placeholders and never formatted: the BiDi attribute lookup and unsupported option types in `OptManager.make_parser`.

## Facts and sources

- <https://opennavo.com/apps/mitmproxy>
- <https://opennavo.com/apps/mitmproxy/versions>
- <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/m/mitmproxy.rb> · Checked 2026-11-21
- <https://formulae.brew.sh/cask/mitmproxy>
- <https://github.com/mitmproxy/mitmproxy> · Checked 2026-11-13
