> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pwnbook.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Network Tester

> Deploy lightweight agents across your infrastructure to run commands and craft network packets from within target environments.

The Network Tester lets you deploy agents onto hosts inside a target environment and interact with them directly from Pwnbook. Once an agent is running, you can issue commands, view output in real time, and send crafted network packets — all without leaving the project.

<Note>Network Tester is available on select plans. Contact your administrator if the feature is not visible in your project.</Note>

## Overview

Network Tester has two main capabilities:

* **Agents** — Lightweight processes you deploy on target hosts. Agents check in with Pwnbook, receive commands, and return results. Useful for running reconnaissance, scripts, or arbitrary commands from inside a network segment.
* **Packet crafting** — Build and send custom network packets (TCP, UDP, ICMP, and more) with full control over headers and payloads. Supports reusable templates and a community template library.

## Deploying an agent

<Steps>
  <Step title="Open the deployment wizard">
    Navigate to **Network Tester** inside your project and click **Deploy Agent**. The wizard walks you through naming the agent and selecting a deployment method.
  </Step>

  <Step title="Choose a runtime">
    Agents are available in multiple runtimes to match what's available on the target host:

    | Runtime    | Requirements                                |
    | ---------- | ------------------------------------------- |
    | Python     | Python 3.9+, no external dependencies       |
    | Bash       | Any POSIX shell                             |
    | PowerShell | PowerShell 5.1+ (Windows or cross-platform) |
    | Go         | Pre-compiled binary, no runtime needed      |
  </Step>

  <Step title="Run the agent on the target host">
    Copy the generated command or script and run it on the target host. The agent connects back to Pwnbook and appears in the agent list once it checks in.
  </Step>
</Steps>

## Managing agents

The **Agents** tab lists all agents for the current project, along with their status, last seen time, and host details (hostname, OS, IP address).

From the agent list you can:

* **Issue commands** — Send a shell command and view stdout, stderr, and exit code in the results panel.
* **View history** — Browse all previously issued commands and their output.
* **Configure check-in interval** — Control how frequently the agent polls for new commands.
* **Delete an agent** — Removes the agent record. The process on the target host will stop receiving commands.

<Tip>Agents continue running on the target host until stopped manually. After deleting an agent in Pwnbook, terminate the agent process on the host.</Tip>

## Packet crafting

The **Packet Crafter** lets you build and send network packets directly from Pwnbook or via a deployed agent.

### Supported protocols

* **TCP** — Configure flags (SYN, ACK, FIN, RST, PSH, URG), window size, and options.
* **UDP** — Set checksum behavior and payload.
* **ICMP** — Type and code selection, payload.
* **Raw / custom** — Manual header construction for other protocols.

Both IPv4 and IPv6 are supported.

### Templates

Save packet configurations as templates to reuse across tests. Templates can be:

* **Custom** — Private to your organization.
* **Community** — Shared templates published by the Pwnbook community. You can import community templates and customize them before use.

To save a new template, configure your packet and click **Save as Template**. Templates appear in the template catalog and can be launched directly from there in future sessions.

## Running scripts

The **Script Runner** tab lets you send multi-line scripts to a connected agent and stream the output back as it executes. Useful for longer automation tasks or when you need to run a sequence of commands in a single session.