Skip to content

Step 3 Configuration

Jayofelony edited this page Feb 21, 2026 · 7 revisions

Configuring your Pwnagotchi

Pwnagotchi works on a default configuration, which you can customize to your liking. The default configuration file can be found at /etc/pwnagotchi/defaults.toml. Editing this file is useless, any changes made will be reverted on reboot. As mentioned you can customize your Pwnagotchi with a custom config file. You can do this easily when you have an SSH connection made.

Automated creation of your configuration file

If you're new and not yet as adventurous as some there is a helpful tool to start creating your first configuration. Created by @wpa2.

Manual editing

Your custom configuration file can also be edited manually:

  • sudo nano /etc/pwnagotchi/config.toml
  • there is also a shortcut command config And this will open the config.toml ready for editing.

This will open a file editor, and create the file (config.toml) if it does not exist. Make any adjustments as you see fit.

  • CTRL + S will save the file
  • CTRL + X will close the file, if any changes have been made and not yet saved it will ask you if you want to save the changes.

Previous: Installation Next up: Customization

Clone this wiki locally