Burp Suite Community

If you're looking for the Burp Suite Professional Docker container, look here (separately maintained).

This allows you to run Burp Suite Community in a Docker container. This guide describes the steps to run Burp on a Mac, but steps for Linux and Windows should be fairly similar.

Prerequisites

You need to have the following installed on your host:
- Docker
- An X Server (macOS: XQuartz)

⚠️ Reboot your system after installing an X Server

Setup

This process can be replicated on Windows or Linux with your choice of X11 server by setting it to listen on 127.0.0.1.

Enable XQuartz > Preferences > Security > Allow connections from network clients
Start the X window server on localhost with XQuartz

xhost + 127.0.0.1

Note that you need to run this command from your host, not the XQuartz terminal.

Installing

From Docker Hub

The prebuilt container can be retrieved from Docker Hub.

docker pull hexcowboy/burpsuite
docker image tag hexcowboy/burpsuite burpsuite

Building the image

First, clone this GitHub repository on your host:

git clone https://github.com/hexcowboy/docker-burp-suite-community.git && cd docker-burp-suite-community

Then, build the Docker image using the following command.

docker build -t burpsuite .

While building the image, the latest JAR (Java ARchive) of Burp Suite Community is pulled from the PortSwigger portal.

Usage

docker run --rm \
  -p 8080:8080 \
  burpsuite

You could make this command more easily accessible by putting it an executable, and make sure that it is available in your $PATH. Alternative, you could create wrapper functions for your docker run commands (example).

Burp Proxy

By default the container listens on port 8080 on all interfaces (see config/project_options.json).

Verify that the proxy is working by running the following command on your host:

curl -x http://127.0.0.1:8080 http://example.com

Notes

When prompted, do not updated Burp Suite through the GUI. Pull and build an updated image instead.
Any changes to the config/ files will be loaded by Burp Suite after building.

hexcowboy / docker-burp-suite-community