# Burp Suite Professional — macOS **One-command installer & launcher for Burp Suite Professional on macOS**
*Supports Apple Silicon (M1/M2/M3/M4) and Intel Macs*
[](https://www.apple.com/macos/) [](https://adoptium.net/) [](https://www.gnu.org/software/bash/) [](LICENSE)
   

---

✨ 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)

```bash # 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](https://www.oracle.com/java/technologies/javase/jdk21-archive-downloads.html) 2. Open the `.dmg` → double-click `JDK 21.pkg` 3. Verify: ```bash 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"

```bash brew install --cask temurin ``` Or download from [adoptium.net](https://adoptium.net/).

❌ UnsupportedClassVersionError (class file version 65.0)

This means Burp Suite was compiled for **Java 21** but you're running an older version. ```bash # Check your current version java -version # Upgrade to Java 21+ brew install --cask temurin ``` After upgrading, verify: ```bash 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`: ```bash 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: ```bash file $(which java) # Should show: Mach-O 64-bit executable arm64 ``` If not, reinstall with Homebrew: ```bash brew install --cask temurin ```

❌ "burp: command not found"

The launcher wasn't added to your PATH. Run: ```bash # 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](https://github.com/ReXiOP) 💻 Full-Stack Developer  ·  🔒 Security Enthusiast  ·  ⚡ Automation Lover
[](mailto:dev.sajid09@gmail.com) [](https://github.com/ReXiOP)
---
**If this project helped you, consider giving it a ⭐**