raspberrypi-build/README.md

raspberrypi-build

Tool used to create custom Debian GNU/Linux images for Raspberry Pi. Based on pi-gen tool used to create the official raspberrypi.org Raspbian images.

Table of contents

• Dependencies
• Build
• System configuration

Dependencies

On Debian-based systems:

apt-get install bash quilt parted qemu-user-static debootstrap zerofree \
dosfstools libcap2-bin grep rsync binfmt-support

Build

Run sudo ./run ./build.sh && sudo ./run ./mkimg.sh to build the image. The following files will be created:

• rootfs/ - the root file system (/ and /boot/ partitions)
• deploy/raspberrypi.img - the image to write to SD card

WARNING

During the execution of sudo ./run ./build.sh host directories /dev, /dev/pts, /proc and /sys are binded into rootfs/ to provide environment for chroot. They are unmounted in the end of script. However, script may fail, so they will remain mounted. If you run sudo rm -rf rootfs/, you can corrupt your host operating system state and you will have to reboot. Please be careful.

System configuration

The following information can be helpful when you connect:

• Root password is disabled
• User user has access via SSH with password password
• SSH host keys are generated at first startup, so fingerprint is different for each installation of the same image
• User has passwordless sudo