1. Support Center
  2. Documentation
  3. Enterprise Edition
  4. Getting started
  5. Deploying to the cloud
  6. AWS

Deploying Burp Suite Enterprise Edition on AWS

To deploy Burp Suite Enterprise Edition on AWS, you need to set up a basic AWS environment, deploy an external database, and then install the application using a CloudFormation template.

Set up your Virtual Private Cloud

You need to set up a suitable Virtual Private Cloud (VPC) in which to host the application cluster.

  1. Either identify a suitable VPC, or create a new one specifically for Burp Suite Enterprise Edition.
  2. Make sure that the "DNS Hostnames" and "DNS Resolution" configuration options are enabled.
  3. Make a note of the VPC ID. You will need to enter this in the CloudFormation template later.
  4. Allocate two IP address subnets from the VPC IP address range to the application cluster. We recommend allocating at least half of a class C network to each subrange. For example:
    Subnet 1a = 10.20.30.0/25
    Subnet 1b = 10.20.30.128/25

    Note: You do not have to create these subnets, just make sure that these address ranges are available on the VPC.

Set up your database

When running Burp Suite Enterprise Edition on the cloud, you need to use an external database. You can use any of our supported external databases. For beta testing, we recommend using Amazon's Relational Database Service (RDS).

  1. Create an RDS instance.
  2. Follow the instructions for setting up an external database. Make a note of the JDBC URL format. You will need to enter this in the CloudFormation template later.
  3. Configure the database security group so that the 2 subnets you created earlier can access the database.

Deploy Burp Suite Enterprise Edition using a CloudFormation template

Once your cloud environment is set up, you can begin installing Burp Suite Enterprise Edition using the provided CloudFormation template.

  1. Go to the release notes for the version of Burp Suite Enterprise Edition that you want to deploy. Copy the URI for the CloudFormation template.
  2. Log in to your AWS console and go to "Services" > "CloudFormation" to open the CloudFormation console.
  3. Click "Create Stack".
  4. In the "Amazon S3 URL" field, enter the template URL that you copied from the Burp Suite Enterprise Edition release notes. Click "Next".
  5. In the "Stack Name" field, enter a name to help you identify the stack later, for example, burp-suite-enterprise.
  6. Fill in the "AWS Credentials" section. We recommend using a dedicated AWS access key for the beta trial as this will potentially change to an IAM role in future.
  7. Under "Network Configuration", enter the VPC ID and the two subnet IP address ranges that you allocated earlier.
  8. Under "Cluster Configuration", choose the number of nodes and the node machine size that you want to use.
  9. Under "Database Configuration", enter the JDBC URL and credentials for your external database.
  10. Under "Admin User", enter the login credentials and email address that you want to use as the admin user. These are the credentials that you will use to log in and perform the initial setup of Burp Suite Enterprise Edition once it has been deployed.
  11. Click "Next" and then click "Next" again.
  12. Select the "I acknowledge that CloudFormation might create IAM resources" checkbox, then click "Create Stack".
  13. Wait until the status is "CREATE_COMPLETE". This normally takes about 15-20 minutes.
  14. From your AWS console, go to "Services" > "EC2" to open the EC2 console.
  15. Click "Load Balancers".
  16. In the filter bar at the top of the page, enter Name : <your-stack-name>. This is the name you specified when creating the stack earlier, for example, Name : burp-suite-enterprise.
    Note: The spaces before and after the colon are important.
  17. Press the enter key to apply the filter. Only one result should be returned.
  18. Select this entry and, from the "Description" tab, copy the "DNS name".
  19. Access this DNS name using your browser. You should be taken to the Burp Suite Enterprise Edition login page.
  20. Log in using the admin username and password that you specified earlier. When prompted, activate your license. You are now ready to start using Burp Suite Enterprise Edition.