Skip to content
Configuring a Pwnagotchi Install in 2023

Configuring a Pwnagotchi Install in 2023

Configuring a Pwnagotchi install in 2023

Whether your Pwnagotchi SD card has become corrupted, is no longer booting, or you're simply setting up a new device, creating a new install of the Pwnagotchi on your SD card is the solution you're looking for. This step-by-step guide is designed to ensure a smooth process, getting your Pwnagotchi in (or back in) action swiftly. Let's get started!


Before we begin, ensure you have the following on hand:

  • An SD card writer.
  • Software for imaging. We recommend using Balena Etcher.
  • The latest Pwnagotchi image which has waveshare v3 drivers. You can download it here.

Step-by-Step Guide to Reimaging Your SD Card

1. Image the SD Card Start by connecting your SD card to your computer using the SD card writer. Open Balena Etcher (or your chosen imaging software) and select the Pwnagotchi image you've downloaded. Begin the imaging process and wait for it to complete.

2. Setting Up the Config File Once you've successfully imaged your SD card:

  • Remove the SD card from the writer.
  • Reinsert the SD card into your computer. It should automatically load the boot partition.

3. Create a Config File

  • On the mounted file system, create a new file and name it config.toml.
    • Important: Use a text editor, not a document editor for this step. Programs like Word or WordPad create enriched text documents that the Pwnagotchi cannot read. We recommend using text editors like Visual Studio Code or Notepad.
    • Also Important: Ensure that, if using Windows, the OS is set to not hide file extensions. Windows has a habit of renaming files to .txt, and config.toml will work, but config.toml.txt will not. 
  • Copy and paste the following configuration into the config.toml file: = "pwnagotchi"
main.lang = "en"
main.plugins.grid.enabled = true = true
ui.display.enabled = true
ui.display.type = "waveshare_3"
ui.display.color = "black"
  • Save the file and ensure you don't modify anything else on the SD card.

4. Eject and Power Up

  • Safely eject the SD card from your computer.
  • Insert the SD card back into your Pwnagotchi device.
  • Connect your Pwnagotchi to a power source. If you're unsure which port to use, it's the left-most port when you're looking at the Pwnagotchi's face. Alternatively, think of it as the USB port closest to the paracord loop.

Note: Give your Pwnagotchi up to 10 minutes to initialize and build after powering up.

Congratulations! You've successfully reimaged your Pwnagotchi SD card. Your device should now be up and running with the latest features and improvements. If you encounter any issues, remember to revisit the guide and ensure all steps were followed correctly. Happy hacking!

Cart 0

Your cart is currently empty.

Start Shopping