Install with the default options

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 set up a standard instance of Burp Suite Enterprise Edition on a single machine, 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.

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.

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.

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.

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.

Click Finish & login to complete the configuration process and open the Sign in 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.

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.

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.