Preparing for the installation

  • Last updated: January 19, 2022

  • Read time: 2 Minutes

Before beginning the installation process, you need to make a few decisions about your landscape. Please make sure you familiarize yourself with the core components and their technical requirements before proceeding, as these affect some of the decisions you need to make.

Before starting the installation process, you need to decide:

  • Whether you want to deploy dedicated agent machines, run agents on the same machine as the Enterprise server, or both.
  • Linux and MacOS only: Whether you want to use an existing operating system user to run the Burp Suite Enterprise Edition services, or create a new user during installation.
  • Which port number you want to use for accessing the web server. The default is 8080, but you can change this during the installation process. This is the port number that users and API clients will use to access the application. The port you choose needs to meet the following requirements:
    • The port must be available for use on the machine where you want to install the Enterprise server and the web server.
    • 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.
  • Whether you want to use TLS on the web server front end. If so, you need a TLS certificate file in PKCS#12 format and a password for the certificate file. Note that this must have the .p12 file extension; certificates in .psx format are not supported.
  • Which username and email address you want to use for the administrator user in Burp Suite Enterprise Edition.
  • Where you want to create folders for the software, data, and logs during the installation process.
  • Whether you want to use the bundled database and migrate to an external one later, or start out with an external database. If so, you will need to perform some additional steps to set up your external database.

You should also review your proposed network topology and check your firewall configuration to ensure that the application components can communicate as needed.