ENTERPRISE

Installing Burp Suite Enterprise Edition

  • Last updated: May 17, 2022

  • Read time: 4 Minutes

This page explains how to perform a standard deployment of Burp Suite Enterprise Edition using the installer. You can run the standard Burp Suite Enterprise Edition installer on both on-premise and cloud-hosted machines.

Note

If you intend to install to cloud-hosted machines, we recommend that you run the installer on each of your machines rather than creating images with Burp Suite Enterprise Edition pre-installed. Adding Burp Suite Enterprise Edition to your images can cause problems with database migrations and potentially prevent Burp Suite Enterprise Edition from running.

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

Note

For information on deploying to Kubernetes via a Helm chart, see Deploying Burp Suite Enterprise Edition to Kubernetes.

Before installation

Before you install Burp Suite Enterprise Edition, you should make sure that you have read the Preparing for the installation page and understood the various configuration options available to you.

Step 1: Download the installer

Download 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

Run the installer and click Next to display the Select Destination Directory page.

Step 2: Choose an install location

Choose an install location

The destination directory is the directory in which the Enterprise server itself will be installed.

Enter or select a directory and then click Next to display the Feedback page. Click Next again to display the Installation options screen.

Step 3: Select the components to install

Select the components to install

The Installation options screen enables you to choose which components of Burp Suite Enterprise Edition you want to install on your machine.

Your choice depends on the scanning configuration you want to run:

  • If you want to run the Enterprise server, web server, and scanning machines all on the same computer, make sure that both the Running the Enterprise server and web server and Running scans boxes are selected.
  • If you want to run scans on a separate machine to the Enterprise server and web server, uncheck the Running scans box.

Note

You need to install the scanning service on any machines that you want to run scans from. For more information, see Deploying additional scanning machines.

Click Next to display the Logs Directory screen.

Step 4: Specify a logs directory

Specify a logs directory

The logs directory is the folder that Burp Suite Enterprise Edition saves all generated logs to.

Enter or select a directory and then click Next to display the Select Components page.

Step 5: Specify a data directory

Specify a data directory

The data directory is the folder that Burp Suite Enterprise Edition saves application data to.

Enter or select a directory and then click Next to display the Web Server Port page.

Step 6: Specify a web server port

Specify a web server port

The web server port is the port through which you can access the Burp Suite Enterprise Edition application in your browser. By default, this is set to port 8080. However, you can specify a different port number if this port is not available on your machine.

Any port you specify must meet the following requirements:

  • The port must be available for use on the machine that you want to install the Enterprise and web servers on.
  • The operating system user must be allowed to bind to that port. On Linux and MacOS, low-privileged users are unable to bind to low port numbers (such as 80 or 433). If you want to use a low port number, you should configure port redirection at the OS level.

Click Next to display the Select User to Run Processes screen.

Step 7: Select a user to run processes

Enter the Username of the system user (that is, the user on your machine as opposed to a Burp Suite Enterprise Edition user) that you want to run Burp Suite Enterprise Edition processes under. If this user does not already exist on your system then the installer creates it at the end of the process.

Click Next to display the Database screen.

Step 8: Select database options

Select database options

Select whether you want to use the Embedded database or your own external database.

Note

Any external database you want to use must meet the Burp Suite Enterprise Edition database requirements. You should also make sure that you have correctly configured the database before proceeding. For more information, see Setting up the external database.

Click Next. The next step differs depending on whether you selected to use the embedded database or an external database:

  • If you selected to use the embedded database then the installer displays the Database Backups Directory screen.
  • If you selected to use an external database then the installer installs Burp Suite Enterprise Edition on your computer. Once installed, it displays a confirmation screen.

Step 9: Specify a database backups directory

Specify a database backups directory

The database backups directory is the folder that Burp Suite Enterprise Edition backs up the embedded database to.

Enter or select a directory and then click Next to install the application.

After installation

Now that you have installed Burp Suite Enterprise Edition, you need to perform some additional configuration in the app itself. To access the configuration page, visit http://localhost:<your-web-server-port> in your browser. By default, this should be http://localhost:8080.

Next step - Configure the application