Burp Suite Professional — macOS

One-command installer & launcher for Burp Suite Professional on macOS
Supports Apple Silicon (M1/M2/M3/M4) and Intel Macs

   

---

✨ Highlights

🚀 Zero-Config Setup Single command to download, configure, and launch. No manual JAR wrangling or classpath headaches.	🍎 Native macOS Support Auto-detects Apple Silicon vs Intel architecture and installs the launcher to the correct bin directory.
☕ Modern Java Compatibility Uses --add-opens JVM flags instead of the deprecated --illegal-access=permit — works with JDK 17, 21, 22+.	🔄 Multi-Version Manager Choose from pre-listed versions or enter any custom version. Switch versions anytime by re-running the installer.

Warning

Auto-Downloader Currently Broken PortSwigger has changed their direct download links, so the automatic download step is currently failing.

Workaround:

1. Download the Burp Suite Professional JAR file manually from portswigger.net/burp/releases.
2. Run this script (sudo ./run.sh) and select Option 7.
3. Provide the path to the downloaded JAR file when prompted.

---

📋 Prerequisites

Requirement	Minimum	Recommended
macOS	Monterey 12.0	Sonoma 15+
Java JDK	21	21+ (Temurin / Oracle)
Disk Space	~500 MB	1 GB
Architecture	Intel x86_64	Apple Silicon arm64

---

🛠️ Installation

Step 1 — Install Java

Option A: Homebrew (Recommended)

# Eclipse Temurin JDK 21+ (open-source, well-maintained)
brew install --cask temurin

# Verify
java -version

Option B: Oracle JDK

1. Download JDK 21 for macOS from Oracle
2. Open the .dmg → double-click JDK 21.pkg
3. Verify:

java -version

Step 2 — Clone & Run

git clone https://github.com/ReXiOP/Burp-Suite-Professional-macOS.git
cd Burp-Suite-Professional-macOS
chmod +x run.sh
sudo ./run.sh

You'll see an interactive menu:

┌─────────────┐
│┏━┓┏━┓ ┏┓╻╺┳┓│
│┗━┓┣━┫  ┃┃ ┃┃│
│┗━┛╹ ╹┗━┛╹╺┻┛│
└─────────────┘

Available Burp Suite Pro Versions:
1) 2025.5.6  (latest)
2) 2025.5.5
3) 2025.4.2
4) 2025.3.1
5) 2024.12.2
6) Custom version (download manually)
7) Use local JAR file (enter path manually)

Select option [1-7]:

The script will:

1. ⬇️ Download the selected JAR from PortSwigger CDN
2. 🔑 Launch the keygenerator
3. 🚀 Create and install a global burp launcher
4. ▶️ Start Burp Suite Professional

Step 3 — Launch Anytime

burp

The launcher is installed to /opt/homebrew/bin/burp (Apple Silicon) or /usr/local/bin/burp (Intel).

---

📂 Project Structure

Burp-Suite-Professional-macOS/
│
├── run.sh                      # Main installer & setup script
├── loader.jar                  # Java agent loader
├── keygen.jar                  # License key generator
├── README.md                   # This file
├── _config.yml                 # GitHub Pages config
│
├── assets/
│   └── css/                    # Styling assets
│
└── (generated at runtime)
    ├── Burp_Suite_Pro_*.jar    # Downloaded Burp Suite JAR
    ├── Burp_Suite_Pro.jar      # Symlink → latest version
    └── burp                    # Launcher script

---

🔄 Updating / Switching Versions

Simply re-run the installer and pick a different version:

sudo ./run.sh

The script automatically:

• Downloads the new version
• Updates the symlink to point to the latest JAR
• Rebuilds the launcher

Tip: Previous JAR files are kept so you can manually switch back if needed.

---

🐛 Troubleshooting

❌ "Java is not installed"

brew install --cask temurin

Or download from adoptium.net.

❌ UnsupportedClassVersionError (class file version 65.0)

This means Burp Suite was compiled for Java 21 but you're running an older version.

# Check your current version
java -version

# Upgrade to Java 21+
brew install --cask temurin

After upgrading, verify:

java -version
# Should show: openjdk version "21.x.x" or higher

❌ "Permission denied"

Make sure the script is executable and you're running with sudo:

chmod +x run.sh
sudo ./run.sh

❌ Burp fails to start on Apple Silicon

Ensure you're running an arm64-native JDK, not an x86 one under Rosetta:

file $(which java)
# Should show: Mach-O 64-bit executable arm64

If not, reinstall with Homebrew:

brew install --cask temurin

❌ "burp: command not found"

The launcher wasn't added to your PATH. Run:

# Add the current working directory to your PATH
echo 'export PATH="'$(pwd)':$PATH"' >> ~/.zshrc
source ~/.zshrc

---

⚙️ How It Works

sudo ./run.sh
       │
       ▼
┌──────────────┐     ┌─────────────────┐     ┌──────────────┐
│  Java Check  │────▶│  Download JAR    │────▶│  Keygen      │
│  + Arch Detect│     │  (curl from CDN) │     │  (background)│
└──────────────┘     └─────────────────┘     └──────┬───────┘
                                                     │
                                                     ▼
                     ┌─────────────────┐     ┌──────────────┐
                     │  Install to     │◀────│  Create      │
                     │  /opt/homebrew  │     │  Launcher    │
                     │  or /usr/local  │     │  Script      │
                     └─────────────────┘     └──────────────┘

---

⚠️ Disclaimer

This project is provided for educational and authorized security testing purposes only.

By using this software, you agree to comply with all applicable laws and PortSwigger's licensing terms. The authors assume no liability for misuse.

---

👨‍💻 Author

Muhammad Sajid — @ReXiOP

💻 Full-Stack Developer  ·  🔒 Security Enthusiast  ·  ⚡ Automation Lover

---

If this project helped you, consider giving it a ⭐