Skip to content

Latest commit

 

History

History
51 lines (37 loc) · 2.36 KB

BUILD.md

File metadata and controls

51 lines (37 loc) · 2.36 KB
Raw

raspberrypi-ua-netinst build instructions

To create an image yourself, you need to have various packages installed on the host machine. On a Debian system those are the following, excluding packages with priority essential and required:

  • git
  • wget
  • bzip2
  • zip
  • xz-utils
  • gnupg
  • kpartx
  • dosfstools
  • binutils
  • bc
  • cpio

On Debian based systems you can install them as root or with sudo as follows:

aptitude install git curl bzip2 zip xz-utils gnupg kpartx dosfstools binutils bc

The following scripts are used to build the raspberrypi-ua-netinst installer, listed in the same order they would be used:

  • clean.sh - Start with a clean slate by removing everything created by earlier builds. This is not needed on a first build, but won't hurt either.

  • update.sh - Downloads latest Raspbian packages that will be used to build the installer.

  • build.sh - Builds the installer initramfs and .zip package for Windows/Mac SD card extraction method. Transfer the .zip package to a Windows/Mac computer, then simply unzip it and copy the files onto a FAT formatted SD card.

  • buildroot.sh - Builds the installer SD card image, it requires root privileges and it makes some assumptions like not having any other loop devices in use. You only need to execute this script if you need more than a .zip package. The script produces an .img package and then its bzip2 and xz compressed versions, but this is configurable (see below).

To set build options, create a file named build.conf, which contains the appropriate variable settings. Supported variables are:

  • mirror_raspbian_cache - Sets a apt caching proxy for the raspbian.org repository. (e.g. "192.168.0.1:3142")
  • mirror_raspberrypi_cache - Sets a apt caching proxy for the raspberrypi.org repository. (e.g. "192.168.0.1:3142")

To set buildroot options, create a file named buildroot.conf, which contains the appropriate variable settings. Supported variables are:

  • compress_bz2=1 - create a bz2-compressed image
  • compress_xz=1 - create a xz-compressed image
  • use_sudo=1 - use passwordless-sudo for operations which require root privileges

By default both bzip2 and xz compressed versions of the image will be created and the uncompressed image will deleted, but either or both can be disabled. If both are disabled, the uncompressed image will be left in place.