Install your Burp Suite Enterprise Edition trial
First things first, let's download and install your trial of Burp Suite Enterprise Edition.
Request a trial license
If you haven't already done so, you need to request a trial license. Go to portswigger.net/burp/enterprise, click "Try for free", and enter a few basic details about yourself. An email will be sent to the address you provide containing instructions about how to download your license key.
You can download your license key again at any time from your account page on
Check your firewall configuration
The various components of Burp Suite Enterprise Edition need to communicate through specific ports. Before starting the installation, it might be necessary for your network administrator to configure your firewall to allow these connections. For many users, this step won't be necessary. However, to avoid potential problems later, check that the following connections are allowed:
- Users need to access the web server on a port of your choosing. By default, this is 8080, but you can choose a different one during the installation.
The Enterprise server needs to access
portswigger.neton port 443 to activate your license.
- The Enterprise server needs to access your SMTP server to send emails. The port number depends on which email service you use. You should be able to find out which port this is by searching online or in the documentation of your email service provider.
- The agents need to be able to access websites that you want to scan, for example, on ports 80 and 443.
Install Burp Suite Enterprise Edition
Don't worry, this process is relatively quick and easy thanks to the installation wizard that guides you through the process. The steps should mostly be self-explanatory, but we've included some more information here just in case.
Go to your account on
portswigger.net. Under "Your licenses and products", download the latest version of Burp Suite Enterprise Edition and open the installer.
- Accept the terms and conditions, then confirm the default directories for installing Burp Suite Enterprise Edition and its logs and data folders.
You will be asked which components you want to install.
For now, select both "Enterprise server and web server" and "Enterprise agent".
- Select a port on which users will access the web server. The default is 8080. However, if port 8080 is unavailable, you might need to choose a different port. Note that throughout this guide, we assume that you are using port 8080.
On Linux and MacOS, you are asked to set the name of a dedicated "run as" user. This is purely a technical setting and is not the user that you use to log in. Leave this as the default
- Burp Suite Enterprise Edition allows you to use an embedded database installed on the same machine as the Enterprise server, or an external database. For now, please select the "Embedded database" option. You can migrate to an external database when you upgrade to a full license if necessary.
- Finally, enter a username, valid email address, and password that you want to use for the administrator of Burp Suite Enterprise Edition. For now, please enter the username "administrator" and use your own email address. Remember these credentials because you'll need them to log in and complete the setup process. If you forget them, you will have to restart the installation process to create a new administrator user.
- Click "Finish".
The installation is now complete and the Enterprise server is running on
http://your-web-server-ip:8080 by default. For now, you will only be accessing the application from the machine on which you installed it, so you can just use the
http://127.0.0.1:8080. Let's take a look at what you need to do the first time you start Burp Suite Enterprise Edition.