Raspberry Pi Zero W / Pi 5
Rasbian Installation
Download the image from here if you want the minimal version (recommended for the Zero W) and flash it to an SD card, otherwise you can just use the flasher to download an image. You can set up the networking here
Headless installation
https://www.tomshardware.com/reviews/raspberry-pi-headless-setup-how-to,6028.html / https://thedatafrog.com/en/articles/raspberry-pi-zero-headless-install/ have some guides on headless installs, which is important for the Pi Zero W
Networking
NB when flashing the standard raspberry pi OS and having set up everything, expect to wait a LONG time (1/2 an hour) before the wifi connects to the network properly. This is quite annoying in a headless install, but you should seethe green light next to the power port flashing. To enable USB in the standard OS you need to do stuff. The pwnagotchi image has done the stuff for you.
If for some reason the wifi doesn't work, you can create a wpa_supplicant.conf file manually in the root of the SD card
ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=netdev
update_config=1
country=FI
network={
ssid="Name Of My Network"
psk="Network_Password"
key_mgmt=WPA-PSK
}
Turn off wifi powersaving, which can lead to ping / ssh / network drops
You can try to check the state of power management:
sudo iw wlan0 get power_save
try toggling it off:
sudo iw wlan0 set power_save off
USB Gadget
You will need to install the RNDIS driver from https://github.com/dukelec/mbrush/tree/master/doc/win_driver for Windows 11
Updating
After logging in, it will try to download from http://mirror.truenetwork.ru
So edit /etc/apt/sources.list and add
(32 bit)
deb http://mirror.transip.net/raspbian/raspbian/ bookworm main contrib non-free rpi
(64 bit)
deb [ arch=armhf ] http://mirror.transip.net/raspbian/raspbian/ bookworm main contrib non-free rpi
remove everything from /var/cache/apt/
then apt-get update and apt-get upgrade
after this you will notice that a few packages have been held back from upgrading.
apt full-upgrade will fix this
after restart it will take a long time after the Pi connects to the wifi network before the ssh connection will work. Once you get a stead return from ping -t, then you can ssh in.
USB Ports
Note: the middle micro USB port (to the right of the HDMI port and left of the USB power port) is used for communication
General Configuration
raspi-config
Is your friend
HW Trouble
OK01 LED blinks 3 times - move the /boot/start.elf to a new name and rename it back / use a different SD card / reformat the SD card