Support Center

Burp Community

See what our users are saying about Burp Suite:

How do I?

New Post View All

Feature Requests

New Post View All

Burp Extensions

New Post View All

Bug Reports

New Post View All

Burp Suite Documentation

Take a look at our Documentation section for full details about every Burp Suite tool, function and configuration option.

Full Documentation Contents Burp Projects
Suite Functions Burp Tools
Options Using Burp Suite

Burp Extender

Burp Extender lets you extend the functionality of Burp Suite in numerous ways.

Extensions can be written in Java, Python or Ruby.

API documentation Writing your first Burp Suite extension
Sample extensions View community discussions about Extensibility
Name is required.
Email address is required.
Invalid email address
Answer is required.
Exceeding max length of 5KB

burp command line

hong Jan 31, 2017 03:34PM UTC

I would like to bring up BURP using command line (without any GUI) for automation.

Is there a way to bring it up without a project file? If I do not specify the project file on the command line, it will bring up GUI which I do not want to see.

java -jar -Djava.awt.headless=true -Xmx1g burpsuite_file.jar --config-file=file1 --config-file=file2


Dafydd Stuttard Jan 31, 2017 03:37PM UTC Support Center agent

If you launch Burp in headless mode then it won’t show a GUI ever. It will load with a default temporary project unless you specify a project file.

Try moving -Djava.awt.headless=true to straight after your java command.

hong Feb 01, 2017 03:22AM UTC
thanks, will give it a try. So using following command, I will bring up burp with a default temporary project with two config files, correct?

java -jar -Xmx1g burpsuite_file.jar -Djava.awt.headless=true --config-file=file1 --config-file=file2

Dafydd Stuttard Feb 01, 2017 08:45AM UTC Support Center agent

Give it a try and find out, otherwise try:

java -Djava.awt.headless=true -Xmx1g -jar burpsuite_file.jar —config-file=file1 —config-file=file2

samira seifi Sep 03, 2017 05:23AM UTC
I have same problem?
Do you find a way to run burp without UI?

Paul Johnston Sep 04, 2017 09:17AM UTC Support Center agent

Hi Samira,

Did you try -Djava.awt.headless=true ? That works fine for us. If it’s not working for you, please describe exactly what you’re seeing, including the precise command line.

Deepak Sharma Apr 28, 2018 05:05AM UTC

I need help to run burp in command line for automation purpose. Whatever we do with gui can we do with command in cmd. If you have a link please share it.
And also let me know is there any way to automate burp with QA.


Paul Johnston Apr 30, 2018 07:19AM UTC Support Center agent

Hi Deepak,

Burp only has limited command line support. Many of the actions are GUI only. For automation, there is the Carbonator extension:


You may also be interested in the Burp REST API:


With the current version of Burp, automation is possible, but you will have to do a bit of work to get it working properly. In future versions of Burp this will be better supported.

Post Your public answer

Your name
Your email address