Burp Suite Complete Beginner Guide 2026

·

Burp Suite is the industry-standard web application security testing platform used by penetration testers and bug bounty hunters worldwide. Developed by PortSwigger, it acts as a proxy between your browser and the web, letting you intercept, inspect, and modify every HTTP/HTTPS request and response in real time.

This guide covers everything a beginner needs to know: installing Burp Suite, configuring your browser proxy, installing the CA certificate for HTTPS interception, and using the core tools — Proxy, HTTP History, Repeater, Intruder, and the built-in Scanner. All testing must be performed only on applications you own or have written authorization to test.

◈ Table of Contents

01 What is Burp Suite 02 Installation & Setup 03 Browser Proxy Configuration 04 HTTPS Interception (CA Cert) 05 HTTP History & Intercept 06 Repeater — Manual Testing 07 Intruder — Automated Attacks 08 Scanner & Extensions
🔎

01 — WHAT IS BURP SUITE & WHY USE IT

BEGINNER
01
Burp Suite Overview & Editions
Foundation

Burp Suite operates as an intercepting proxy — it sits between your browser and the target web application, capturing every request and response. This gives you total visibility and control over web traffic. It is used in 99% of web application penetration tests.

EditionPriceKey Features
CommunityFreeProxy, Repeater, Intruder (throttled), Decoder, Sequencer, Spider
Professional~$499/yrAll Community features + full Scanner, faster Intruder, BApp Store access, Collaborator
EnterpriseCustomAutomated CI/CD scanning, scheduled scans, team management

Start with Community Edition — it covers 80% of manual testing workflows. Intruder is rate-limited (1 thread, slower) but still functional for learning. PortSwigger also offers a free Web Security Academy (portswigger.net/web-security) with labs that work perfectly with the Community Edition.

💾

02 — INSTALLATION & FIRST LAUNCH

BEGINNER
01
Install on Kali Linux, Windows & macOS
Install

Burp Suite comes pre-installed on Kali Linux. On other platforms, download the installer from portswigger.net. Burp requires Java 21+ which is bundled in the installer.

KALI LINUX — PRE-INSTALLED
# Launch from applications menu or terminal burpsuite # Update to latest version sudo apt update && sudo apt install burpsuite -y
UBUNTU / DEBIAN
# Download the Linux installer from portswigger.net/burp/communitydownload chmod +x burpsuite_community_linux_v*.sh ./burpsuite_community_linux_v*.sh
WINDOWS & MACOS
# Download the Windows .exe or macOS .dmg installer # from: https://portswigger.net/burp/communitydownload # Run the installer — Java is bundled, no separate JDK needed # Launch: Start Menu (Windows) or Applications (macOS)
◈ First Launch Steps
  • 1
    Launch Burp Suite and select Temporary project for quick testing (or save project for assessments)
  • 2
    Select Use Burp defaults for initial configuration
  • 3
    Click Start Burp — you're now inside the Burp Suite dashboard
  • 4
    Familiarize yourself with the top tabs: Proxy, Target, Repeater, Intruder, Scanner, Decoder, Sequencer, Extender
🌐

03 — BROWSER PROXY CONFIGURATION

BEGINNER
01
Configure Firefox (Recommended)
Proxy Setup

Burp Suite listens on 127.0.0.1:8080 by default. You need to point your browser at this proxy so that Burp can intercept all traffic. Firefox is recommended for Burp testing because it has its own proxy settings, independent of the OS.

◈ Firefox Manual Proxy Setup
  • 1
    Open Firefox → Settings → search "proxy" → click Settings... under Network Settings
  • 2
    Select Manual proxy configuration
  • 3
    Set HTTP Proxy: 127.0.0.1, Port: 8080
  • 4
    Check "Also use this proxy for HTTPS"
  • 5
    Click OK and confirm in Burp: Proxy → Options → Proxy Listeners should show 127.0.0.1:8080 running

Install the "FoxyProxy Standard" Firefox extension for quick proxy switching between Burp and direct browsing. Set a profile for Burp (127.0.0.1:8080) and toggle with one click — no need to enter manual settings every time.

02
Configure Chrome / Chromium
Chrome

Chrome uses the OS system proxy settings, so you need to configure it via command line or use an extension like SwitchyOmega.

CHROME — LAUNCH WITH PROXY FLAG (LINUX)
# Launch Chrome with Burp proxy google-chrome --proxy-server="127.0.0.1:8080" --ignore-certificate-errors & # Or Chromium chromium --proxy-server="127.0.0.1:8080" --ignore-certificate-errors &
CHROME EXTENSION METHOD (ALL PLATFORMS)
# Install "Proxy SwitchyOmega" from Chrome Web Store # Create a new profile: Name = "Burp" # Protocol: HTTP, Server: 127.0.0.1, Port: 8080 # Click "Apply changes" and switch to "Burp" profile when testing
🔒

04 — HTTPS INTERCEPTION (CA CERTIFICATE)

BEGINNER
01
Install Burp's CA Certificate
HTTPS

To intercept HTTPS traffic, Burp issues its own TLS certificates signed by a Burp CA. Your browser needs to trust this CA, otherwise you'll get SSL errors on every HTTPS site. This is a one-time setup per browser.

◈ Install CA Certificate in Firefox
  • 1
    With browser proxy configured, navigate to: http://burp (or http://127.0.0.1:8080)
  • 2
    Click "CA Certificate" button at the top right — downloads cacert.der
  • 3
    Firefox → Settings → Privacy & Security → Certificates → View Certificates
  • 4
    Authorities tab → Import → select the downloaded cacert.der
  • 5
    Check "Trust this CA to identify websites" → OK
  • 6
    Test: visit https://example.com with Burp intercepting — no SSL error = success
⚠️

Never install Burp's CA certificate in your default browser profile used for personal browsing. Use a dedicated browser profile or instance for Burp testing. Trusting an additional CA weakens your browser's security for everyday use.

📈

05 — HTTP HISTORY & INTERCEPT

BEGINNER
01
Understanding the Proxy Tab
Core Workflow

The Proxy tab is Burp's heart. The "Intercept" sub-tab lets you pause requests before they reach the server. "HTTP history" shows every request/response that has passed through Burp — this is where you do most of your initial analysis.

◈ Key Proxy Controls
  • 1
    Intercept On/Off: When ON, each request pauses and waits for your action (Forward/Drop/Send to Tool). Turn OFF when just browsing to collect history.
  • 2
    HTTP history: Browse to your target with Intercept OFF — all requests populate here. Right-click any request → "Send to Repeater", "Send to Intruder", "Add to scope".
  • 3
    Request view: See the raw HTTP request. Every parameter, cookie, and header is visible and editable.
  • 4
    Response view: See the server's raw response. Look for interesting data, tokens, error messages, and stack traces.
  • 5
    Scope: Set your target scope (Target → Scope) to filter history to only your target domain and avoid accidental testing of other sites.

Right-click any request in HTTP History and select "Show response in browser" to copy a one-time URL that renders the response in your browser — useful for viewing complex pages like formatted HTML reports or checking how response tampering looks in context.

🔄

06 — REPEATER — MANUAL REQUEST TESTING

BEGINNER → INTERMEDIATE
01
Using Repeater for Manual Testing
Repeater

Repeater is your primary tool for manual vulnerability testing. You send a request here from Proxy History, then modify and resend it as many times as you want — testing different payloads, parameter values, and observing the target's response each time.

◈ Repeater Workflow
  • 1
    In HTTP History, find an interesting request (login, search, API call) → right-click → "Send to Repeater"
  • 2
    Click the Repeater tab → you'll see the raw HTTP request on the left
  • 3
    Modify the request: change a parameter value, add headers, inject a test payload like ' or <script>
  • 4
    Click Send → inspect the response on the right for errors, different behavior, or data exposure
  • 5
    Use the arrow keys to navigate request history — compare responses to understand what each change triggers
EXAMPLE — TESTING SQL INJECTION WITH REPEATER
# Original request (from HTTP History) POST /login HTTP/1.1 Host: target.local Content-Type: application/x-www-form-urlencoded username=admin&password=password123 # Modified in Repeater — inject SQL payload POST /login HTTP/1.1 Host: target.local Content-Type: application/x-www-form-urlencoded username=admin'--&password=anything # Watch the response: SQL error? Successful login? Different page length? # Each variation tells you something about the vulnerability

Use Ctrl+Space in Repeater to open the request tab menu. You can organize multiple Repeater tabs by naming them (double-click the tab) — useful when testing multiple endpoints simultaneously during a larger assessment.

📷

07 — INTRUDER — AUTOMATED ATTACKS

INTERMEDIATE
01
Intruder Attack Types
Intruder

Intruder automates sending a large number of modified requests, making it ideal for brute force attacks, fuzzing parameters, and credential testing. In Community Edition, requests are rate-throttled but the functionality is the same.

Attack TypeHow It WorksBest For
SniperOne payload set, cycles through each marked position one at a timeSingle-parameter fuzzing
Battering RamOne payload set, inserts same value into all positions simultaneouslyTesting same value in multiple params
PitchforkMultiple payload sets, iterates each in parallel (position 1 with list 1, etc.)Username + password pair lists
Cluster BombMultiple payload sets, tries every combination (Cartesian product)Brute force all combos
◈ Running a Brute Force Attack (Pitchfork)
  • 1
    Send a login request from HTTP History to Intruder (right-click → Send to Intruder)
  • 2
    In Intruder → Positions tab: click Clear § to remove auto-detected positions
  • 3
    Highlight the username value → click Add §. Do the same for password value. Select Pitchfork attack type
  • 4
    Payloads tab: Payload set 1 = usernames list, Payload set 2 = passwords list. Load from file or paste values
  • 5
    Click Start attack → sort results by Status Code or Response Length — a different response length often indicates a valid credential
⚠️

Brute force attacks against login pages without authorization constitute unauthorized access under computer crime laws. Only use Intruder against your own applications or those you have written permission to test. Always check for account lockout policies before running large attacks.

📊

08 — SCANNER, DECODER & EXTENSIONS

INTERMEDIATE
01
Passive & Active Scanning
Scanner

Burp Pro's Scanner automatically identifies vulnerabilities like XSS, SQL injection, SSRF, and more. Community Edition includes Passive Scanner only, which flags issues like information disclosure and insecure headers without sending additional requests.

◈ Using Scanner (Pro) / Passive Scanner (Community)
  • 1
    Passive scan: Automatic — Burp analyzes all proxied traffic as you browse and flags issues in the Issues panel
  • 2
    Active scan (Pro): Right-click any request → "Scan" → choose "Active scan" or "Audit" to send crafted payloads
  • 3
    Review findings in Target → Issues tab — sorted by severity (Critical/High/Medium/Low/Info)
  • 4
    Click any finding for detail: description, evidence, request/response, remediation advice
02
Decoder & Essential Extensions
Tools

Decoder converts data between encoding formats (URL, Base64, HTML, Hex) — critical for understanding and crafting tokens and payloads. The BApp Store (Extender tab) provides community extensions.

DECODER — COMMON OPERATIONS
# Decode a URL-encoded string Input: username%3Dadmin%26password%3Dtest Decode as: URL Output: username=admin&password=test # Decode a JWT token (header + payload) Input: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9... Decode as: Base64 Output: {"alg":"HS256","typ":"JWT"}
Essential BApp Extensions (BApp Store)
  • Logger++ — enhanced request/response logging with search and filter
  • JWT Editor — view, edit, and attack JSON Web Tokens
  • Autorize — automatically test for broken access control (IDOR)
  • Param Miner — discover hidden/guessable parameters in web requests
  • Hackvertor — advanced encoding and payload generation
  • Turbo Intruder — high-speed request sending (bypasses throttle)

PortSwigger Web Security Academy (portswigger.net/web-security) has 200+ free labs that teach every web vulnerability with a browser-based target. It's the best free practice environment — all exercises work with Burp Suite Community Edition.


⚠️

Burp Suite is a powerful offensive tool. Only use it against web applications you own or have explicit written authorization to test. Unauthorized testing is illegal under computer crime laws worldwide. CyberHawk Threat Intel and the author accept no responsibility for unauthorized use.

◈ Stay Connected

Follow CyberHawk Threat Intel for penetration testing tutorials, threat intelligence, and hands-on security content.

🌐 Website ▶️ YouTube 𝕏 Twitter/X ♫ TikTok ✈️ Telegram
📝 Blog 📚 Courses 📋 SOPs 🔍 IOC Scanner

"They can't exploit you if you are the Exploit."