This script automates the installation, setup, and configuration of Burp Suite Professional on macOS. It handles downloading the necessary keygen, modifying JVM options, and fixing common macOS-specific issues to ensure Burp Suite runs smoothly.
- Developer: @anbuinfosec
- GitHub Repository: Burp Suite Pro Mac
Download the latest version from the official website:
https://portswigger.net/burp/pro
Install the app to the default directory:
/Applications/Burp Suite Professional.app
Get the setup script from GitHub:
git clone https://github.com/anbuinfosec/burp-pro-mac.git
cd burp-pro-macchmod +x burp.shRun the script with any of the following options:
| Option | Description |
|---|---|
-setup |
Setup Burp Suite Professional (download keygen, config) |
-fix |
Fix macOS quarantine issues causing app damage errors |
-run |
Launch the BurpLoaderKeygen registration machine |
-help |
Show help and usage information |
sudo ./burp.sh -setup
sudo ./burp.sh -fix
./burp.sh -run
./burp.sh -help-
Homebrew & Java Check Verifies if Homebrew and Java (OpenJDK) are installed. If missing, it automatically installs them for you.
-
Keygen Download Downloads
BurpLoaderKeygen.jarto the Burp Suite resources directory if not already present. -
JVM Configuration Appends JVM flags in
vmoptions.txtto allow Burp Suite to run with the keygen agent. -
Quarantine Fix Removes the macOS quarantine attribute to fix
"damaged and can't be opened"errors. -
Run Registration Machine Starts the BurpLoaderKeygen jar to register Burp Suite.
The keygen is automatically downloaded from the following release URL:
- This script assumes Burp Suite Professional is installed in
/Applications/Burp Suite Professional.app. - Running with
sudomay be required to modify application files and remove quarantine attributes. - The script is tested on macOS only.
- Java installation via Homebrew is targeted to the latest OpenJDK version.
- JVM options appended to
vmoptions.txtare necessary for Burp Suite to load the keygen agent.