first run (mac)

First run

Congratulations, your SD card should be now ready for boot! Safely remove your SD card from your computer, and insert it into your Raspberry Pi. There are two USB ports on your Pi 0, labeled as “PWR IN” and “DATA”, see this image:

Insert your USB cable into the “DATA” port, and connect it to your PC. The green LED on your Pi should start blinking quickly for a while, that means it is starting up. In the meantime, you can enable Bluetooth and Hotspot on your phone, so you can get up and running. The process of booting up for the first time can take few minutes or up to tens of minutes depending on your SD card, so give it a little while. In the meantime, you can make yourself a coffee, have a snack, or join our community Discord and get to know the most amazing people!

SSH into your pi…

… on MacOS

Steps in MacOS Are similar to Linux, and this example is based on Intel MacOS Sonoma, however it shouldn’t be too much different for any other mac versions. First of all connect your Raspberry Pi to your Mac, I used an usb to type-c adapter, but if you own a microusb-typec cable you can use that! After you plug it in open your system settings ( > System Settings) and go to the “Network” section. You should see a window like this:

After plugging the Raspberry Pi in we should automatically see our ethernet connection:

Now click on the new network (RNDIS/Ethernet Gadget for me) and click on Details. You should see a screen popping up and click TCP/IP and set Configure IPv4 from DHCP to Manually then configure everything else like below.

And go to DNS Section now and enter your desired DNS Server(i.e 9.9.9.9 or 8.8.8.8) by clicking + sign like below:

Note: If you cannot connect to the internet from your MacOS After this click on (… > Set Service Order…) drag the interface you use for internet to the top.

After all of these click OK it might ask for your password and then the status should change from ‘Self Assigned’ IP to ‘Connected’ you are all done! Open your favorite terminal, and type in ssh <username>@10.0.0.2, where <username> is pi by default. Enter the password the default is raspberry.

Common issues

> New Network Interface after every boot (MAC-Adress)

This happens, because the pwnagotchi generates a new MAC-address after every reboot. To set a static MAC-address see Common Issues

> After computer reboot, my Pwnagotchi doesn’t connect to internet anymore

This also happens because the pwnagotchi generates a new MAC-address after every boot. Fix: Common issues