# Installation

![Extension loaded in Burp Suite](https://710436228-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK0ure45w5tAMFDkq49ZN%2Fuploads%2Fgit-blob-3ab4dc55daaa7f21acc433baded8c3eb49a360e6%2Finstallation-extension-loaded.png?alt=media)

## 📋 Prerequisites

Before installing Burp Bounty Pro, ensure you have the following:

* ✅ **Burp Suite Professional** installed on your system (Community Edition has limited scanning capabilities)
* ✅ **Java Runtime Environment (JRE)** version 14 or above

## 🔧 Installation Steps

### 1️⃣ Download the Extension

Obtain the latest version of Burp Bounty Pro from the official website at [bountysecurity.ai](https://bountysecurity.ai) or from your purchase confirmation email.

### 2️⃣ Launch Burp Suite

Open Burp Suite Professional.

### 3️⃣ Add the Extension

1. Navigate to the **Extensions** tab (formerly called "Extender")
2. Click on the **Installed** sub-tab
3. Click the **Add** button

![Add button in Extensions tab](https://710436228-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK0ure45w5tAMFDkq49ZN%2Fuploads%2Fgit-blob-d7229577ed9ac22de40e1e738678f3cf0dfe3997%2Finstallation-add-button.png?alt=media)

### 4️⃣ Configure the Extension

In the dialog that appears:

1. Select **Java** as the extension type
2. Click **Select file...** and choose the `BurpBountyPro.jar` file you downloaded
3. Click **Next** to proceed with the installation

![Add extension dialog](https://710436228-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK0ure45w5tAMFDkq49ZN%2Fuploads%2Fgit-blob-9a9706b131d4785294ea47ed53d59051b7c34759%2Finstallation-add-dialog.png?alt=media)

### 5️⃣ Verify Installation

Ensure that:

* ✅ The extension is listed in the **Installed** extensions list with the checkbox ticked
* ✅ No errors appear in the extension output panel
* ✅ The **Burp Bounty Pro** tab appears in the main Burp Suite tab bar

![Burp Bounty Pro tab visible](https://710436228-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK0ure45w5tAMFDkq49ZN%2Fuploads%2Fgit-blob-34b319191221e82bfcb0175bb0ca7d2b1114c76f%2Finstallation-tab-visible.png?alt=media)

### 6️⃣ Start Using Burp Bounty Pro

Access the newly added **Burp Bounty Pro** tab in the Burp Suite interface. You're ready to begin configuring your profiles and start your security testing! 🎉

## 🚀 First Launch

When Burp Bounty Pro loads for the first time, it will:

1. 📦 **Auto-load default profiles** — 254 pre-configured scanning profiles are loaded from the bundled `BurpBountyData` directory
2. 📋 **Auto-load default rules** — 27 Smart Scan rules are loaded for automated vulnerability detection
3. 🔀 **Initialize default variables** — Global variables like `{REDIRECT_DOMAIN}` are set to their default values

A new **Burp Bounty Pro** tab will appear in the main Burp Suite interface with sub-tabs for Dashboard, Scanner, Profiles, Rules, Options, Variables, License, and About.

![First launch with default profiles](https://710436228-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK0ure45w5tAMFDkq49ZN%2Fuploads%2Fgit-blob-c8561b8228fb9d9f2f83b00d680e5e16442c1124%2Finstallation-first-launch.png?alt=media)

## 🔑 License Activation

1. Navigate to the **Burp Bounty Pro** tab
2. Click the **License** sub-tab
3. Enter your license key
4. Click **Activate**

![License activation tab](https://710436228-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK0ure45w5tAMFDkq49ZN%2Fuploads%2Fgit-blob-8cac27593ab2bc267e6d2ceba30f9e9d86efb3b8%2Finstallation-license.png?alt=media)

## ✅ Verifying Installation

After installation, verify that:

* ✅ The **Burp Bounty Pro** tab appears in the main Burp Suite window
* ✅ The **Dashboard** sub-tab shows the scan control buttons (Pause All, Resume All, Stop, Clear Issues)
* ✅ The **Profiles** sub-tab lists loaded profiles across all three tables:
  * 🎯 **Active Profiles** — with columns: Enabled, Profile Name, Tags, Author's Twitter
  * 📨 **Passive Request Profiles** — with columns: Enabled, Profile Name, Tags, Author's Twitter
  * 📩 **Passive Response Profiles** — with columns: Enabled, Profile Name, Tags, Author's Twitter
* ✅ The **Rules** sub-tab shows the 27 default rules

## 📌 Post-Installation

After installing Burp Bounty Pro, you may want to:

* 📦 **Review Default Profiles** — Familiarize yourself with the 254 default profiles provided and adjust them to fit your testing needs. Use the tag dropdown to browse by category (XSS, SQLi, CVEs, etc.)
* 🚀 **Explore the Quick Start** — Follow the [Quick Start](https://docs.bountysecurity.ai/getting-started/quick-start) guide to run your first scan in under 5 minutes
* 🔀 **Configure Variables** — Set your `{REDIRECT_DOMAIN}` and `{ATTACKER_DOMAIN}` in the Variables tab
* 🔄 **Check for Updates** — Check for updates regularly to ensure you have the latest features and fixes

## 🔄 Updating

Burp Bounty Pro has a built-in update checker that detects new versions of both the extension and the profiles.

### Check For Updates

1. Go to the **Burp Bounty Pro** tab > **About** sub-tab
2. Click the **Check For Updates** button
3. The extension will check for:
   * 🆕 **New versions of Burp Bounty Pro** — If a new version is available, you'll be notified and can download it
   * 📦 **New versions of the profiles** — Updated and new scanning profiles are downloaded and installed automatically

![About tab with Check For Updates](https://710436228-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK0ure45w5tAMFDkq49ZN%2Fuploads%2Fgit-blob-c6fe7c0f98e00bf6e8e565cb618df9d8c2d987f7%2Fabout-check-for-updates.png?alt=media)

> 💡 **Tip:** Check for updates regularly to get the latest vulnerability detection profiles and bug fixes.

> 📝 **Note:** Your existing profiles, rules, and settings are preserved across updates.

## 🔗 Resources

| Resource           | Link                                                                               |
| ------------------ | ---------------------------------------------------------------------------------- |
| 📖 Documentation   | [burpbounty.bountysecurity.ai](https://burpbounty.bountysecurity.ai/burp-bounty/)  |
| 🎥 Video Tutorials | [YouTube Channel](https://www.youtube.com/channel/UCSq4R2o9_nGIMHWZ4H98GkQ/videos) |
| 🌐 Main Website    | [bountysecurity.ai](https://bountysecurity.ai)                                     |
| 🐦 Twitter         | [@BountySecurity](https://x.com/BountySecurity)                                    |
| 📧 Support         | <hello@bountysecurity.ai>                                                          |

## ❓ Need Help?

If you encounter any issues during the installation or have questions about using Burp Bounty Pro, please:

* 📖 Check the [FAQ](https://docs.bountysecurity.ai/appendix/faq) for common solutions
* 📧 Contact our support team at **<hello@bountysecurity.ai>**