raspberrypios-setup

• prepare a Raspberry Pi OS image for a headless installation based on the original downloaded zipped image file
• currently, the script does 3 things:
  • enable ssh for first boot (https://layereight.de/raspberry-pi/2017/02/28/ssh-headless-Raspberry-Pi.html)
  • precreate user for unattended setups (https://www.raspberrypi.com/news/raspberry-pi-bullseye-update-april-2022/)
  • change the hostname
• requires sudo permissions in order to mount an image partition in a loop device

Prerequisites

• installed software:
  • xz
  • fdisk
  • openssl

Usage

raspberrypios-setup.sh <ZIPPED_RASPBERRYPIOS_IMAGE> <HOSTNAME> <USER> <PASSWORD>

# typical run

$ ~/bin/raspberrypios-setup.sh /data/software/raspberrypios/2025-12-04-raspios-trixie-arm64-lite.img.xz homecenter pi raspberry 
Zipped image: /data/software/raspberrypios/2025-12-04-raspios-trixie-arm64-lite.img.xz
Working directory: /data/software/raspberrypios
Unzipping...
/data/software/raspberrypios/2025-12-04-raspios-trixie-arm64-lite.img.xz (1/1)
  100 %     487.4 MiB / 2,848.0 MiB = 0.171   430 MiB/s       0:06             
Unzipped image file: /data/software/raspberrypios/2025-12-04-raspios-trixie-arm64-lite.img
Image sector size: 512 bytes
Boot partition start at: 8388608 bytes
Root partition start at: 545259520 bytes
Temp image mounting directory: /tmp/tmp.b90mgJ081P
[sudo] password for user: 
Create /ssh in boot partition
Create /userconf in boot partition
pi:$6$EdXf87PUxNU7i/dE$8NYNEm/D.Rwiovav9XE6OgZmTTvT/xwN2BfVZketVrEHH46H1G4cbuxNlp5ZnFym75e6kbArOKydy/EUETh96.

Contents of /etc/hostname in root partition:
homecenter

Contents of /etc/hosts in root partition:
127.0.0.1	localhost
::1		localhost ip6-localhost ip6-loopback
ff02::1		ip6-allnodes
ff02::2		ip6-allrouters

127.0.1.1		homecenter

DONE. Your prepared image file is in /data/software/raspberrypios/2025-12-04-raspios-trixie-arm64-lite.img

Copy the resulting image

• in a separate step

#
# typical target devices (use lsblk to find out)
# /dev/mmcblk0 for sdcard reader
# /dev/sdX for USB sticks
#
sudo dd if=/data/software/raspberrypios/2025-12-04-raspios-trixie-arm64-lite.img of=/dev/mmcblk0 status=progress