Public | Automated Build

Last pushed: a day ago
Short Description
Official Docker images for mitmproxy, an interactive SSL-capable intercepting HTTP proxy.
Full Description


Containerized version of mitmproxy, an interactive SSL-capable intercepting HTTP proxy.


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

The volume mount is optional: It's to store the generated CA certificates.

Once started, mitmproxy listens as a HTTP proxy on localhost:8080:

$ http_proxy=http://localhost:8080/ curl
$ https_proxy=http://localhost:8080/ curl -k

You can also start mitmdump by just adding that to the end of the command-line:

$ docker run --rm -it -p 8080:8080 mitmproxy/mitmproxy mitmdump

For mitmweb, you also need to expose port 8081:

# this makes :8081 accessible to the local machine only
$ docker run --rm -it -p 8080:8080 -p mitmproxy/mitmproxy mitmweb

For further details, please consult the mitmproxy documentation.


The available release tags can be seen here.

Thanks to Werner Beroux and David Weinstein for their invaluable help with the mitmproxy Docker images!

Docker Pull Command
Source Repository

Comments (6)
12 days ago

I docker run with "-p ip:8081:8081 mitmweb", saw errors "connection refused " when browsing the http://ip:8081. Anyone encountered this issue ? Thanks.

9 months ago

I pushed a issue in github for this docker image, not sure if this is a good place, but pasted the link here.

a year ago

@jeffreycharles: Fixed, thanks! :)

We don't get notifications for comments here, so please file an issue in the repo if there's something that needs our attention.

a year ago

The latest tagged image appears to be 0.17. I would've expected it to be the latest stable (0.18.2) or master. Also having a 0.18.2 tagged one would be nice.

a year ago

@iseedeadpeople: We are porting mitmproxy to Python 3 and we will remove Python 2 support from the project with one of the next releases. The last Docker image using Python 2.7 will be 0.17.


a year ago

Is it me or... You guys recently decided to upgrade Python from 2.7 to 3.5?
If that's the case, is there anyway I can get in touch with mitmproxy:dev (0.18) with python 2.7?