__               _      _ __   _____ 
 / /              (_)    | |\ \ |  _  |
| | __   __  ___   _   __| | | || |/' |
| | \ \ / / / _ \ | | / _` | | ||  /| |
| |  \ V / | (_) || || (_| | | |\ |_/ /
| |   \_/   \___/ |_| \__,_| | | \___/ 
 \_\                        /_/

voidzero

Utility to get a Raspberry Pi Zero running on Void Linux with the basics setup in just over 5 minutes.

Quick start

Plug in your sdcard device (let’s assume it’s /dev/sdd).

./flash.sh /dev/sdd
./mount.sh /dev/sdd
./stage.sh
./install.sh
sync
umount -R /dev/sdd

Then plug into your Raspberry Pi Zero device and enjoy!

flash.sh and mount.sh

Both take a device argument i.e. ./flash.sh /dev/sdd. Note that flash.sh won’t work if your devices are numbered mmcblk0p1 etc as it just adds a 2 to the end of the input argument to pass to the resize tools. It’s relatively easy to just fix this in the script.

stage.sh

The staging script runs off environment variables for Wi-Fi and USB gadget networking. It also copies your ssh .pub key into the staging/priv/root/.ssh/authorized_keys file (touch or manually fill this file if you want a different key).

You should rm -rf staging/priv/etc/ssh and re-run this script if you want to regenerate rpi0 sshd host keys.

Wi-Fi networking

WPA_SSID=MySSID
WPA_PSK=MyPSK

USB networking

DEVICE_SUBNET=192.168.1
DEVICE_CIDR=24
DEVICE_ID=254

This will result in a 192.168.1.245/24 address for the usb0 interface with a default gateway of 192.168.1.1.

install.sh

Installs onto ./mmc. Does a bunch of things, just check the script if you want to know more, it’s not very complex.

Dependencies

• wpa_passphrase
• ssh-keygen
• install
• pv
• dd
• sfdisk
• e2fsck
• resize2fs