Private Burp Collaborator

Why I needed to build a private burp collaborator server

The main reason was to use custom domain like names instead of

Step 1: Create AWS EC2 server - free tier

You need a EC2 server, you can use EC2 free tier or buy EC2 server, whichever works for you. I have used free tier. For the complete steps follow the Main Reference.

Specifications (already there in main reference) :

  • OS : latest ubuntu (free tier)
  • Hardware: t2.micro
  • Disk Space < 30GB
  • hours/month = 750 hours (if you are using only one server then you dont have to worry). Read AWS documentation to understand how “hours” are billed.
  • Validity = 1 year
  • Make sure you select an alert of free tier (this is not mentioned in Main Reference). This will ensure that you will be notified if you are charged additional cost.

An Important instruction about this AWS elastic IPs

  • The assigned AWS IP address will change if you reboot or restart the server. This will affect your AWS public dns name, which means your nameserver record of your domain has to be changed. And even after changing all these value and deploying a new burp collaborator server, you may get error while deployment.
  • In this case, (the only way for me that worked was), buy a new domain (free in my case). Map that domain to this new AWS domain name. And now don't stop the server.

Step 2: Buy Domain Name

Buy using Godaddy

Refer this article, Godaddy steps are different from others. But godaddy is paid, so I would prefer freenom instead.

Buy using freenom

  • After buying the domain (valid for 1 year) go to the domain setting and click nameserver
give your AWS EC2 public dns name in 1 and same in 2

Step 3: Allow the required ports

As you already know, this is not a sensitive server. We will not be using it to save any sensitivities data, it will only be used for validating/checking the out-of-band attacks.

these are required, else the final health check will fail.

Step 4: Installing and configuring collaborator server.


On the AWS Ubuntu Server

You need to download the latest burpsuite pro software (.sh format) and copy it to the ~/privatecollaborator folder. A burpsutie license is not require, just the installation files are.

git clone && cd privatecollaborator
sudo ./
sudo ./
sudo service burpcollaborator start

Step 5: At the burp collaborator client’s end

Step 1..4 are for burp collaborator server. This is the server which is the main component. This next step is the burp collaborator client. The client gives a gui to see the results and generate new out-of-band checking URLs.

  • click “Copy to clipboard”.
  • paste in on the search bar of your browser
  • then come back to the client and click on “Poll now”
  • You should see a list of entries, this validates that the burp collaborator is working properly

If you are getting an error

If you are facing issues in here, given you have properly followed each and every step, then it means the Main Reference is not appliance at that point of time. But I would highly suggest you to review all steps as these worked for me.

What Next?

Burp collaborator is useful but there is a restriction how can you use it. And the most important requirement is, the collaborator client should be able to connect to collaborator server. If due to some reason the testing environment does not allow this, then burp collaborator will be of no use. Also you do not see all requests for the private collaborator, the client will only show requests originating from the client only. To solve this problem you can follow the below article,



Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store