Getting Started

Everything you need to get your PwnPower device up and running.

Quick Start

  1. Power on the device
  2. Connect to the PwnPower WiFi network (password: password)
  3. Open https://pwnpower.local in your browser
  4. Complete the setup wizard (first boot only)
  5. You’re ready to go!

First Boot Setup

On first power-up, PwnPower displays a setup wizard:

  1. Set a password - This secures the web interface
  2. Configure the AP - Optionally change the network name and password
  3. Connect to home WiFi - Optional, enables remote access via pwnpower.local

The wizard only appears once. After completion, you’ll see the main interface.

What PwnPower Does

PwnPower is an ESP32-C3/C5 based WiFi security auditing tool. It creates an access point you connect to, providing a web interface for:

  • Scanning - Discover nearby networks and connected clients
  • Attacking - Deauthentication attacks to disconnect devices
  • Capturing - WPA handshakes for offline password cracking
  • Monitoring - Track device presence patterns over time
  • Alerting - Discord/Slack notifications for device events

Autonomous Operation

Once configured, PwnPower works unattended:

  • Scans continuously in the background
  • Tracks device arrivals and departures
  • Captures handshakes when idle (if enabled)
  • Sends webhook alerts based on your filters

You can check in anytime via the web interface, or just let it run and collect data.