1. Support Center
  2. Documentation
  3. Desktop Editions
  4. Getting Started
Professional Community

Getting Started With Burp Suite

Note: Using Burp Suite may result in unexpected effects in some applications. Until you are fully familiar with its functionality and settings, you should only use Burp Suite against non-production systems.

Launching Burp

Download the Burp Suite installer for your required platform (Windows, MacOS, or Linux) from the PortSwigger.net website.

Run the installer and select any desired options within the installation wizard.

Launch Burp Suite by clicking the installed application shortcut. On Linux, the shortcut is located in the installation path that was displayed/selected during installation.

You can also launch Burp Suite from the command line to specify additional options and command line arguments.

Startup Wizard

When Burp launches, the startup wizard is displayed. This lets you choose what Burp project to open, and what project configuration to use.

Selecting a Project

You can choose from the following options to create or open a project:

Note: You can rename a project later via the Burp menu.

Selecting a Configuration

You can choose from the following options for the project configuration:

Opening a Project From a Different Burp Installation

If you open an existing project that was created by a different installation of Burp, then Burp will prompt you to decide whether to take full ownership of the project.

This decision is needed because Burp stores within the project file an identifier that is used to retrieve any ongoing Burp Collaborator interactions that are associated with the project. If two instances of Burp share the same identifier in ongoing work, then some Collaborator-based issues may be missed or incorrectly reported. You should only take full ownership of a project from a different Burp installation if no other instance of Burp is working on that project.

Display Settings

The first time you run Burp, it is worth taking a moment to check your display settings. Burp lets you select different sized fonts for different parts of the UI, and you may want to change these settings, depending on your screen resolution.

First, look at the text shown in Burp's menus, tab captions, buttons and other text. If you want to change the main UI font size, go to the Options tab, then go to the Display sub-tab, and edit the font size in the User Interface section. Then restart Burp and check whether the new font is suitable.

Second, go to the Repeater tab and look at the HTTP message shown in the request panel. If you want to change the font size for HTTP messages, go to the Options tab, then go to the Display sub-tab, and edit the font size in the HTTP Message Display section. Then go back to the Repeater tab and check whether the new font is suitable (there is no need to restart).

Next Steps

Use the links below for further help on starting to use Burp: