# Web Debugger

> Inspect HTTP requests and responses in real time. Modify and replay traffic to debug web applications with Pinggy Web Debugger
> Source: https://pinggy.io/docs/http_tunnels/web_debugger/


# Web Debugger

## Overview

The **Web Debugger** is a powerful feature provided by Pinggy to inspect HTTP requests and responses in real-time. It allows users to monitor, debug, and analyze tunnel traffic, including headers, payloads, and other request details. This is particularly useful for developers who need to troubleshoot web applications or APIs hosted on localhost.

![Web Debugger to live inspect, analyze, modify and replay http requests.](/assets/webdebugger.webp)



## Getting Started

To enable the Web Debugger, you need to configure a tunnel with the Web Debugger port specified. This feature is available for HTTP and HTTPS tunnels.


1. **Start a Tunnel with Web Debugger**:
   Use the Pinggy CLI or SSH command to start a tunnel and specify the Web Debugger port (e.g., `4300`). For example:

   ```bash
   ssh -p 443 -R0:localhost:8080 -L4300:localhost:4300 free.pinggy.io
   ```

   Here, `-L4300:localhost:4300` specifies that the Web Debugger will be accessible on port `4300`.
   
   You can change it to some other port as follows:

   `-L9999:localhost:4300` specifies that the Web Debugger will be accessible on port `9999`.

2. **Access the Web Debugger**:
   Open your browser and navigate to `http://localhost:4300` to access the Web Debugger interface. You will see a dashboard displaying live request and response data.

3. **Using the Pinggy CLI**:
   Alternatively, you can use the Pinggy CLI to start a tunnel with the Web Debugger enabled:

   ```bash
   ./pinggy -p 443 -R0:localhost:8080 -L4300:localhost:4300 free.pinggy.io
   ```

4. **Programmatic Access with APIs**:
   Retrieve tunnel URLs and Web Debugger data programmatically by sending a GET request to `http://localhost:4300/urls`. Example response:

   ```json
   {
     "urls": [
       "http://rnckk-23.4.5.6.run.pinggy-free.link",
       "https://rnckk-23.4.5.6.run.pinggy-free.link"
     ]
   }
   ```

   Similarly, to get the list of whitelisted IP addresses, send a GET request to `http://localhost:4300/ipwhitelist`.

   Get other tunnel settings from `http://localhost:4300/ipwhitelist`.

## Features

After opening the web debugger (such as by visiting `http://localhost:4300`, you will be able to do the following:

- **Live Request Inspection**: View incoming HTTP requests, including headers, methods, and payloads.
- **Response Monitoring**: Inspect server responses, including status codes and response headers.
- **Modification and replay**: Modify HTTP requests including all headers, and replay the requests to debug your applications.
- **Custom Port Configuration**: Run the Web Debugger on a user-specified port for easy access.
- **Zero Trust Mode**: If you do not want Pinggy to read your data, then use [TLS tunnels](/docs/tls_tunnels/)
. This will create end-to-end encrypted connections from the browser to your local HTTPS servers. Pinggy or any other actor cannot read your data, maintaining privacy.