Get involved in the Burp challenge for opportunities to test your skills and win swag  –   Challenge me

ENTERPRISE

Install with the default options

  • Last updated: November 30, 2022

  • Read time: 3 Minutes

This quick start guide will get your trial of Burp Suite Enterprise Edition up and running 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 suitable for trials only.

At a minimum, we recommend starting out on a machine with at least 8 CPU cores and 24 GB of RAM. A machine of this spec would be suitable to run one concurrent scan only.

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.

Warning

There are potential security implications to leaving Burp Suite Enterprise Edition in an unconfigured state. We recommend completing the rest of the configuration as soon as possible.

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. The Username is automatically set to administrator, and cannot be changed.

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 just created.


Activating your license

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

Uploading the license key

Note

You need one license for each server instance of Burp Suite Enterprise Edition that you intend to run. For example, if you wanted to run separate installations in your test and production environments then you would need to purchase separate licenses.

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 from the PortSwigger site

Follow the instructions in your registration email to download your license key.

Step 2: (optional) Set up a proxy server

To activate your license, Burp Suite Enterprise Edition needs to connect to portswigger.net on port 443. If you require a proxy server to access the public web, click Configure Proxy Settings.

Setting up the proxy

To configure a proxy server:

  1. Enter Host and Port details for your proxy server.
  2. If the server requires authentication, select Authenticated and enter Username and Password details.
  3. Click Save & continue to return to the Upload your license key page.

Step 3: Upload your license key to Burp Suite Enterprise Edition

When prompted, click Upload license key and select your key from the dialog.

Step 4: Start the onboarding wizard

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

Next step - Run your first scan

Was this article helpful?