Installing Burp Suite Enterprise Edition (Standard)

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

Before installation

Before you install Burp Suite Enterprise Edition, you should make sure that you have understand the prerequisites for standard installation, and have the relevant information to hand.

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.

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

Step 2: Extract and run the installer

This step is specific to your operating system.

Windows:

1. Extract the installer burpsuite_enterprise_windows-x64_vYYYY_MM.exe from the installer zip file.
2. Right-click the installer file and select Run as administrator.

Linux:

1. Extract the installer burpsuite_enterprise_linux_vYYYY_MM.sh from the installer zip file.
2. From the command line, run sudo sh <installer-sh-file> -c.

Step 3: 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 Installation options screen.

Step 4: 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 system architecture you want to deploy:

• For a single-machine architecture - with the Enterprise server and scanning components all on the same machine - make sure that both the Running the Enterprise server and web server and Running scans boxes are selected.
• For a multi-machine architecture - with the Enterprise server and scanning components on separate machines - deselect Running scans to install only the server component.

Click Next to display the Logs Directory screen.

Step 5: 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 Data Directory page.

Step 6: 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.

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 a user at the end of the process with the default name burpsuite.

Click Next to display the Database screen.

Step 8: Select database options

Select whether you want to use the Embedded database or your own external database. Only use the embedded database to evaluate Burp Suite Enterprise Edition. It is not intended for production use.

Click Next to display the Web Server Port screen.

Step 9: 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 if you are using the embedded database or 8443 if you are using an external database. 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, 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.

Step 10: 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.

After installation

Now that you have installed Burp Suite Enterprise Edition, you need to complete the final part of the configuration in the app itself. Access the app in your browser. By default, this should be http://localhost:8080 or https://localhost:8443.