# 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>**


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.bountysecurity.ai/getting-started/installation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.