Research Academy
My account Customers About Blog Careers Legal Contact Resellers

ProfessionalCommunity Edition

Installing extensions manually

  • Last updated: March 31, 2025

  • Read time: 3 Minutes

You can install extensions manually from a file. This is useful when:

  • You want to use a custom extension in .jar, .py, or .rb format. For instructions, see Manually installing a custom extension.

  • You are working offline in Burp and can't access the BApp Store. In this situation, you can use a separate browser to download extensions from the BApp Store on the PortSwigger website and import the .bapp file into Burp. For instructions, see Manually installing a BApp Store extension.

Note

If neither of these situations apply, we recommend installing extensions directly from the BApp Store in Burp. For more information, see Installing extensions from the BApp Store.

If you can't access the BApp Store and you're not intentionally working offline, see our troubleshooting guide.

Manually installing a custom extension

You can install your own Java, Python, or Ruby custom extensions.

Note

If you want to install an extension written in Python or Ruby, you'll need to configure Jython or JRuby before you can add the extension to Burp. For instructions, see our troubleshooting guide.

To install a custom extension:

  1. Go to Extensions > Installed and click Add.

  2. Under Extension Details, use the Extension type dropdown to select the type of extension you want to install. You can choose from Java, Python, or Ruby.

  3. Click Select file and choose the extension file.

  4. [Optional] Under Standard output and Standard error, choose where to save output and error messages.

  5. Click Next to load the extension.

  6. Review any messages displayed in the Output and Errors tabs.

  7. Click Close.

The extension is installed and automatically enabled. It's added to the bottom of the list in Extensions > Installed. Extensions process traffic in list order, so you may want to adjust their position. For instructions, see Managing extensions.

Manually installing a BApp Store extension

You can download extensions from the BApp Store on the PortSwigger website, then install them in Burp.

Note

We review all extensions submitted to the BApp Store, but as they are written by third parties, we can't guarantee their quality or security. As extensions can run arbitrary code, we recommend that you review them yourself before installing. To view the source code for an extension, visit our GitHub page.

For more information about how we protect your data and ensure AI-powered interactions remain secure when using AI-powered extensions, see AI security, privacy and data handling.

To manually install a BApp Store extension:

  1. Go to the BApp Store web page.

  2. Click the name of the extension you want to install. The extension description opens.

  3. Click Download BApp.

  4. If you're using a closed network, move the .bapp file into your network.

  5. In Burp, go to Extensions > BApp Store, click , then select Import BApp file.

  6. Select the file you previously downloaded and click Open.

The extension is installed and automatically enabled. It's added to the bottom of the list in Extensions > Installed. Extensions process traffic in list order, so you may want to adjust their position. For instructions, see Managing extensions.

Was this article helpful?