selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

mitmproxy logo

Self-host mitmproxy

v12.3.1

Interactive TLS-capable intercepting HTTP proxy

ReleaseOpen SourceMIT
Updated3 weeks ago
LanguagePython
Setup difficultyModerate
Stars
46 988
Ports
8080 (HTTP proxy listener), 8081 (Web interface (mitmweb))
Docker
mitmproxy/mitmproxy
Install with Docker
mitmproxy console interface showing intercepted HTTP trafficmitmweb web interface showing request/response details

What is mitmproxy?

An interactive proxy that can intercept TLS-protected traffic, designed for penetration testers and developers. It offers three ways to work: a terminal UI, a command-line dumper similar to tcpdump, and a browser-based interface like Chrome DevTools. The software handles HTTP versions 1, 2, and 3 plus WebSocket protocols, allowing users to capture, examine, alter, and resend requests and responses in real time. A Python API lets you write extensions that automatically transform messages, redirect connections, or add custom commands. You can install it via Homebrew on macOS, as standalone binaries on Linux and Windows, through Docker, or from PyPI using uv. It creates its own CA certificates for HTTPS interception and supports transparent proxy modes. A core team maintains the project with sponsorship from organizations like NLnet.

Should you self-host mitmproxy?

mitmproxy scores 85/100 on selfhost.directory (how scoring works) and ranks #1 of 47 in Network Monitoring. It has 46 988 GitHub stars, +1 565 in the last 30 days.

It shipped 5 stable releases in the past year. The latest, v12.3.1, came out on 25 October 2026. New versions land roughly every 3 months.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is MIT-licensed and written mostly in Python.

Its closest alternative on selfhost.directory is ntopng (71/100, 8 348 stars). mitmproxy scores higher overall. See mitmproxy vs ntopng side by side.

Features

  • Command-line interface (mitmdump)
  • Console interface (mitmproxy)
  • HTTP/1, HTTP/2, HTTP/3, and WebSocket support
  • Intercept, inspect, modify, and replay traffic
  • Message decoding and prettification
  • Proxy modes (regular, transparent, reverse, upstream)
  • Python scripting API
  • TLS/SSL interception with CA certificate generation
  • Transparent proxying support
  • Web interface (mitmweb)

mitmproxy README

mitmproxy

Continuous Integration Status autofix.ci: enabled Coverage Status Latest Version Supported Python versions

mitmproxy is an interactive, SSL/TLS-capable intercepting proxy with a console interface for HTTP/1, HTTP/2, and WebSockets.

mitmdump is the command-line version of mitmproxy. Think tcpdump for HTTP.

mitmweb is a web-based interface for mitmproxy.

Installation

The installation instructions are here. If you want to install from source, see CONTRIBUTING.md.

How to install mitmproxy

Install mitmproxy with Docker

$ docker run --rm -it -v ~/.mitmproxy:/home/mitmproxy/.mitmproxy -p 8080:8080 mitmproxy/mitmproxy

Volume mount persists CA certificates between runs

mitmproxy releases & version history

@ Every self-hosted release, weekly

One Monday email with the week's stable releases across the directory.

More in Network Monitoring

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…