pwnagotchi/docs/configure.md
2019-10-05 17:21:50 -04:00

2.9 KiB

Connecting to your Pwnagotchi

Once you wrote the image file on the SD card, there're a few steps you'll have to follow in order to configure your unit properly. First, start with connecting the USB cable to the data port of the Raspberry Pi and the RPi to your computer. After a few seconds, the board will boot and you will see a new Ethernet interface on your host computer.

You'll need to configure it with a static IP address:

  • IP: 10.0.0.1
  • Netmask: 255.255.255.0
  • Gateway: 10.0.0.1
  • DNS (if required): 8.8.8.8 (or whatever)

If everything's been configured properly, you will now be able to ping both 10.0.0.2 or pwnagotchi.local (if you haven't customized the hostname yet).

You can now connect to your unit using SSH:

ssh pi@10.0.0.2

The default password is raspberry; you should change it as soon as you log in for the first time by issuing the passwd command and selecting a new and more complex passphrase.

If you want to login directly without entering a password (recommended!), copy your SSH public key to the unit's authorized keys:

ssh-copy-id -i ~/.ssh/id_rsa.pub pi@10.0.0.2

Configuration

You can now set a new name for your unit by changing the hostname. Create the /root/custom.yml file (either via SSH or by directly editing the SD card contents from a computer) that will override the default configuration with your custom values.

Language Selection

Pwnagotchi displays its UI in English by default, but it can speak several other languages! You can change main.lang to one of the supported languages:

  • English (default)
  • German
  • Dutch
  • Greek
  • Macedonian
  • Italian
  • French
  • Russian
  • Swedish

Display Selection

Set the type of display you want to use via ui.display.type (if your display does not work after changing this setting, you might need to completely remove power from the Raspberry and make a clean boot).

You can configure the refresh interval of the display via ui.fps. We recommend using a slow refresh rate to avoid shortening the lifetime of your e-ink display. The default value is 0, which will only refresh when changes are made to the screen.

Host Connection Share

If you connect to the unit via usb0 (thus using the data port), you might want to use the scripts/linux_connection_share.sh, scripts/macos_connection_share.sh or scripts/win_connection_share.ps1 script to bring the interface up on your end and share internet connectivity from another interface, so you can update the unit and generally download things from the internet on it.

Troubleshooting

If your network connection keeps flapping on your device connecting to your Pwnagotchi, check if usb0 (or equivalent) device is being controlled by NetworkManager. You can check this via nmcli dev status.