Flashing via Command Line
Flashing your Nugget via Command Line, using ESPTool
Unless you hate Chrome, we recommend checking out our browser flashing guide for an easier experience.
Step 1: Downloads
- Download the latest Nugget Firmware
- Download ESPTool
Step 2: Place Your Nugget in Flash Mode
Next, you’ll have to place your Nugget into DFU
(Device Firmware Upgrade) mode! You can do this in 2 ways:
Option 1:
- Plug the Nugget into your computer
- Hold down the
0
button - Tap & Release the
RST
button
Option 2:
- Hold down the
0
button - Plug in the Nugget
- Release the
0
button

Step 3: Find Serial Port & Erase Flash
- Find the Serial Port (
SERIAL_PORT
) your Nugget is connected to:
- Windows: Found via Device Manager
- MacOS:
ls /dev/cu*
- Linux:
ls /dev/tty*
- Erase the flash:
- Windows / Mac / Linux:
esptool --chip esp32s2 -p <SERIAL_PORT> erase_flash
Step 4: Flashing
Run the following command to flash the latest release file to your Nugget!
- Windows / Mac / Linux
esptool --chip esp32s2 -p <SERIAL_PORT> write_flash -z 0x0 <binary>.bin
Your Nugget is ready to hack!
Once flashing is finished, reset your Nugget to complete the update.
Plug in your USB Nugget and watch it mount as a flash drive. You can open the drive to explore preinstalled payloads and begin to add your own.
You can also connect via the web interface and run payloads from any device! The network name is Nugget and the password is nugget123 to connect. Once connected, navigate to 192.168.4.1
in a browser.