Flashing via Command Line

Flashing your Nugget via Command Line, using ESPTool

Step 1: Downloads

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:

  1. Plug the Nugget into your computer
  2. Hold down the 0 button
  3. Tap & Release the RST button

Option 2:

  1. Hold down the 0 button
  2. Plug in the Nugget
  3. Release the 0 button


Step 3: Find Serial Port & Erase Flash

  1. Find the Serial Port (SERIAL_PORT) your Nugget is connected to:
  • Windows: Found via Device Manager
  • MacOS: ls /dev/cu*
  • Linux: ls /dev/tty*
  1. 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.

← Quick Start
Live Control →