{"id":21015029,"url":"https://github.com/koenrh/docker-burp-suite-pro","last_synced_at":"2025-05-15T05:31:39.590Z","repository":{"id":38333109,"uuid":"132911127","full_name":"koenrh/docker-burp-suite-pro","owner":"koenrh","description":"Burp Suite Professional in a Docker container.","archived":false,"fork":false,"pushed_at":"2023-10-23T20:49:29.000Z","size":66,"stargazers_count":82,"open_issues_count":2,"forks_count":21,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-03T04:33:06.827Z","etag":null,"topics":["burpsuite-pro","docker"],"latest_commit_sha":null,"homepage":"","language":"Dockerfile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/koenrh.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2018-05-10T14:23:01.000Z","updated_at":"2025-02-21T03:59:42.000Z","dependencies_parsed_at":"2022-08-24T05:02:14.250Z","dependency_job_id":"d7e1690a-75b2-4c71-958d-e6e76a65f3aa","html_url":"https://github.com/koenrh/docker-burp-suite-pro","commit_stats":null,"previous_names":[],"tags_count":14,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/koenrh%2Fdocker-burp-suite-pro","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/koenrh%2Fdocker-burp-suite-pro/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/koenrh%2Fdocker-burp-suite-pro/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/koenrh%2Fdocker-burp-suite-pro/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/koenrh","download_url":"https://codeload.github.com/koenrh/docker-burp-suite-pro/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254282013,"owners_count":22045074,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["burpsuite-pro","docker"],"created_at":"2024-11-19T10:08:15.730Z","updated_at":"2025-05-15T05:31:34.577Z","avatar_url":"https://github.com/koenrh.png","language":"Dockerfile","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Burp Suite Pro\n\nThis allows you to run Burp Suite Professional in a container. This guide describes\nthe steps to run Burp on a Mac, but steps for Linux should be fairly similar.\n\n## Prerequisites\n\n- You need a [Burp Suite Professional](https://portswigger.net/burp) license.\n- You need to have the following installed on your host:\n  - [Docker](https://docs.docker.com/install/)\n  - [XQuartz](https://www.xquartz.org/)\n  - [socat](http://www.dest-unreach.org/socat/)\n\n:warning: If you did not have installed XQuartz, make sure to reboot your Mac after\nthe installation so that the X11 window server is set up correctly for the current\nuser.\n\n## Building the image\n\nFirst, clone this GitHub repository on your host:\n\n```bash\ngit clone https://github.com/koenrh/docker-burp-suite-pro.git\n```\n\nThen, build the Docker image using the following command. Provide the email address\nand password (or customer number for some customers) you would normally use to login\nto your PortSwigger account.\n\n```bash\ndocker build -t koenrh/burp-suite-pro \\\n  --build-arg PORTSWIGGER_EMAIL_ADDRESS=\"$PORTSWIGGER_EMAIL_ADDRESS\" \\\n  --build-arg PORTSWIGGER_PASSWORD=\"$PORTSWIGGER_PASSWORD\" .\n```\n\nWhile building the image, the JAR (Java ARchive) of Burp Suite Pro is pulled form\nthe PortSwigger portal.\n\n## Setup\n\n1. Start the X window server by opening XQuartz (`open -a xquartz`).\n1. Expose the local XQuartz socket on TCP port 6000 using `socat`:\n\n```\nsocat TCP-LISTEN:6000,reuseaddr,fork UNIX-CLIENT:\\\"$DISPLAY\\\"\n```\n\nNote that you need to run this command from your host, not the XQuartz terminal.\n\n## Usage\n\n```bash\ndocker run --rm \\\n  -v \"/tmp/.X11-unix:/tmp/.X11-unix\" \\\n  -e \"DISPLAY=docker.for.mac.host.internal:0\" \\\n  -v \"$HOME/src/github.com/koenrh/burp/java:/home/burp/.java\" \\\n  -p 8080:8080 \\\n  --name burp-suite-pro\n  koenrh/burp-suite-pro\n```\n\nYou could make this command more easily accessible by putting it an executable,\nand make sure that it is available in your `$PATH`. Alternative, you could create\nwrapper functions for your `docker run` commands ([example](https://github.com/jessfraz/dotfiles/blob/master/.dockerfunc)).\n\n### Burp Proxy\n\nIn order to make Burp Proxy available to the host, you need to bind on the public\ninterface.\n\n1. In Burp, open the 'Proxy' tab, and then the 'Options' tab.\n1. Add a new 'Proxy Listener' by clicking the 'Add' button.\n1. Enter the preferred port number, and make sure that 'Bind to address' is set\n  to 'All interfaces'.\n1. Verify that the proxy is working by running the following command on your host:\n\n```bash\ncurl -x http://127.0.0.1:8080 http://example.com\n```\n\n## Notes\n\n1. When prompted, do not updated Burp Suite through the GUI. Pull and build an\n  updated image instead.\n1. Do not the delete the mapped `.java` directory on your host. It contains important\n  license activation data.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkoenrh%2Fdocker-burp-suite-pro","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkoenrh%2Fdocker-burp-suite-pro","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkoenrh%2Fdocker-burp-suite-pro/lists"}