ENTERPRISE

Unattended installation of Burp Suite Enterprise Edition

  • Last updated: May 17, 2022

  • Read time: 3 Minutes

Instead of installing Burp Suite Enterprise Edition manually via the installation wizard, you can perform an unattended / silent installation via the command line, passing the required input in a varfile. This is much more efficient when installing on multiple machines.

The easiest way to prepare the varfile is to perform the installation once manually. This will generate a varfile containing the required parameters already. You can then reuse this file to perform future installations unattended.

Note

For a single deployment of Burp Suite Enterprise Edition, you only need one license. It doesn't matter how many scanning machines you deploy, or how many scans you run. However, if you want to deploy Burp Suite Enterprise Edition in multiple environments, you must purchase a separate license for each environment. This also applies to test, development, or staging environments, for example.

If you have any questions about your licensing requirements, please contact our customer support team at hello@portswigger.net.

Performing an unattended installation for scanning machines

To perform an unattended installation for a scanning machine, you can simply copy a response.varfile from an existing scanning machine installation and pass it to the installer from the command line.

Generate a response.varfile for scanning machine deployment

Perform a manual installation using the same options that you want to use for your unattended installations. This generates the response.varfile in the .install4j subdirectory of your installation directory.

Note

If you have already deployed a scanning machine, you can just copy the existing response.varfile.

The default installation directory depends on the operating system you are using:

MacOS

/Applications/Burp Suite Enterprise Edition/.install4j

Windows

C:\Program Files\burpsuite_enterprise\.install4j

Linux

/opt/burpsuite_enterprise/.install4j

Perform an unattended scanning machine deployment using the response.varfile

Perform an unattended installation by running the installer from the command line using your response.varfile.

Burpsuite_enterprise_linux_v2021_8_1.sh -c -q -varfile response.varfile

-c runs the installer in command line mode
-q runs the installer in unattended mode
-varfile allows you to specify a response file

The scanning machine fingerprint is sent to standard output (stdout).

Performing an unattended installation of the Enterprise server

To perform an unattended installation of the Enterprise server, you need to add some values into the response.varfile that are not stored by the installer. You can then pass the edited file to the installer from the command line.

Generate a response.varfile for Enterprise server deployment

Perform a manual installation using the same options that you want to use for your unattended installations. This generates the response.varfile in the .install4j subdirectory of your installation directory.

Note

If you have already deployed an enterprise server, you can just copy the existing response.varfile.

The default installation directory depends on the operating system you are using:

MacOS

/Applications/Burp Suite Enterprise Edition/.install4j

Windows

C:\Program Files\burpsuite_enterprise\.install4j

Linux

/opt/burpsuite_enterprise/.install4j

Example response.varfile

The following is an example of a response.varfile.

beuser=burpsuite beuserandgroup=burpsuite\:burpsuite dataDirectory=/var/lib/BurpSuiteEnterpriseEdition databaseBackupsDirectory=/var/lib/BurpSuiteEnterpriseEdition dbType=h2 escapedDataDir=/var/lib/BurpSuiteEnterpriseEdition escapedInstallationDir=/opt/burpsuite_enterprise jreHome=/opt/burpsuite_enterprise/jre logsDirectory=/var/log/BurpSuiteEnterpriseEdition platformScriptSuffix=sh sys.adminRights$Boolean=true sys.component.agent$Boolean=true sys.component.db$Boolean=true sys.component.enterprise$Boolean=true sys.component.web$Boolean=true sys.installationDir=/opt/burpsuite_enterprise sys.languageId=en sys.programGroupDisabled$Boolean=true webserver_port$Integer=8080

Note

Earlier versions of Burp Suite Enterprise Edition required you to enter additional parameters regarding the database and admin user into the varfile. This is no longer necessary, as this information is now entered during the initial setup process.

Perform an unattended Enterprise server deployment using the response.varfile

Perform an unattended installation by running the installer from the command line using your response.varfile.

Burpsuite_enterprise_linux_v2021_8_1.sh -c -q -varfile response.varfile
  • -c runs the installer in command line mode
  • -q runs the installer in unattended mode
  • -varfile allows you to specify a response file