ENTERPRISE

Install with the default options

  • Last updated: September 9, 2022

  • Read time: 3 Minutes

This quick start guide will get you up and running with Burp Suite Enterprise Edition as quickly as possible. We'll show you how to download and install the software, and perform your first scan of a site.

Specifically, this guide explains how to perform a standard single-machine deployment of Burp Suite Enterprise Edition using the default settings. This configuration is most useful for trials, or if you just want to see what Burp Suite Enterprise Edition can do.

For the best experience, we recommend starting out on a machine with at least 8 CPU cores and 24 GB of RAM.

Note

Step 1: Download and launch the installer

Download and run the installer for Burp Suite Enterprise Edition. The link below opens the download page for the latest stable release in a new tab.

Download the installer

Launching the Burp Suite Enterprise Edition installer

Step 2: Choose a port to use for the web server

In the installation wizard, keep clicking Next to accept the default options until you are prompted to choose a port for the web server. By default, port 8080 is used, but you may need to select a different one if this isn't available on your machine.

Specifying a port for the web server

Keep clicking Next to accept the default for all remaining options until the installation process begins. Please note that this may take a few minutes. If prompted, allow Java to accept incoming connections.

Step 3: Access the configuration page

Once you have installed Burp Suite Enterprise Edition, you will need to perform some additional configuration in the app itself. To access the configuration page, visit http://localhost:8080 in your browser.

Access the configuration page

Step 4: Create an initial admin user

When you first access Burp Suite Enterprise Edition, you're prompted to create an initial admin user. Enter your email address and a secure password. We recommend leaving the default username as administrator.

Configuring admin user

Warning

Keep a note of these credentials. You need them to complete the initial setup and they are not easily recovered if you lose them.

Click Finish & login to complete the configuration process and open the Sign in page.

Accessing the login page

Step 5: Log in as the admin user

Log in using the administrator user that you created in the installation wizard. If you've forgotten these credentials, you need to reset your password via the command line.


Activating your license

The first time you launch Burp Suite Enterprise Edition, you need to activate your license. If you don't have one yet, you can sign up for a free trial or purchase a full license from our website.

Note

For a single deployment of Burp Suite Enterprise Edition, you only need one license. It doesn't matter how many scanning machines you deploy, or how many scans you run. However, if you want to deploy Burp Suite Enterprise Edition in multiple environments, you must purchase a separate license for each environment. This also applies to test, development, or staging environments, for example.

If you have any questions about your licensing requirements, please contact our customer support team at hello@portswigger.net.

Step 1: Download your license key

  • If you have a trial license, follow the instructions in the email we sent you to download your license key.

  • If you have a full license, go to your account page and download your license key using the link provided.

Step 2: Upload your license key

When prompted, upload your license key as instructed.

Activating your license

Note

To activate your license, Burp Suite Enterprise Edition needs to connect to portswigger.net. If you can only access the public web via a proxy server, click Configure Proxy Settings to enable this connection first.

Step 3: Start the onboarding wizard

Once your license is activated, click Continue to begin the onboarding wizard. This will guide you through the process of running your first scan.

Next step - Run your first scan

Was this article helpful?