Skip to content
How To Configure a Pwnagotchi Install In 2024

How To Configure a Pwnagotchi Install In 2024

We've updated our super popular guide to include all the stuff you'll need to re-image our standard deluxe Pwnagotchi in 2024! 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. While designed for Phreak Boutique Pwnagotchi builds, this step-by-step guide is designed to ensure a smooth process, getting most  Pwnagotchi devices 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 or v4 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_4"
ui.invert = false
  • 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