Installation

Please follow the steps for your operating system.

Once installation is complete, you can run mitmproxy, mitmdump or mitmweb from a terminal.

Installation on macOS

You can use Homebrew to install everything:

brew install mitmproxy

Or you can download the pre-built binary packages from our releases.

Installation on Windows

The recommended way to install mitmproxy on Windows is to use the installer provided at mitmproxy.org. After installation, you’ll find shortcuts for mitmweb (the web-based interface) and mitmdump in the start menu. Both executables are added to your PATH and can be invoked from the command line.

Note

Mitmproxy’s console interface is not supported on Windows, but you can use mitmweb (the web-based interface) and mitmdump.

Installation on Linux

The recommended way to run mitmproxy on Linux is to use the pre-built binaries provided at releases.

Our pre-built binaries provide you with the latest version of mitmproxy, a self-contained Python 3.5 environment and a recent version of OpenSSL that supports HTTP/2. Of course, you can also install mitmproxy from source if you prefer that (see Advanced Installation).

Advanced Installation

Docker Images

You can also use the official mitmproxy images from DockerHub. That being said, our portable binaries are just as easy to install and even easier to use. 😊

Installation on Arch Linux

mitmproxy has been added into the [community] repository. Use pacman to install it:

>>> sudo pacman -S mitmproxy

Installation from Source on Ubuntu

Ubuntu comes with Python but we need to install pip3, python3-dev and several libraries. This was tested on a fully patched installation of Ubuntu 16.04.

sudo apt-get install python3-dev python3-pip libffi-dev libssl-dev
sudo pip3 install mitmproxy  # or pip3 install --user mitmproxy

On older Ubuntu versions, e.g., 12.04 and 14.04, you may need to install a newer version of Python. mitmproxy requires Python 3.5 or higher. Please take a look at pyenv. Make sure to have an up-to-date version of pip by running pip3 install -U pip.

Installation from Source on Fedora

Fedora comes with Python but we need to install pip3, python3-dev and several libraries. This was tested on a fully patched installation of Fedora 24.

sudo dnf install make gcc redhat-rpm-config python3-devel python3-pip libffi-devel openssl-devel
sudo pip3 install mitmproxy  # or pip3 install --user mitmproxy

Make sure to have an up-to-date version of pip by running pip3 install -U pip.

Installation from Source on openSUSE

This was tested on a fully patched installation of openSUSE Tumbleweed. Please note that openSUSE Leap 42.2 only comes with Python 3.4.x, whereas mitmproxy requires Python 3.5 or above. You can check you Python version by running python3 --version.

sudo zypper install python3-pip python3-devel libffi-devel openssl-devel gcc-c++
sudo pip3 install mitmproxy

Installation from Source on Windows

Note

Mitmproxy’s console interface is not supported on Windows, but you can use mitmweb (the web-based interface) and mitmdump.

First, install the latest version of Python 3.5 or later from the Python website. During installation, make sure to select Add Python to PATH.

Mitmproxy has no other dependencies on Windows. You can now install mitmproxy by running

pip3 install mitmproxy

Latest Development Version

If you would like to install mitmproxy directly from the master branch on GitHub or would like to get set up to contribute to the project, install the dependencies as you would for a regular installation from source. Then see the project’s README on GitHub. You can check your system information by running: mitmproxy --version