General Build Prerequisites for Image Creation Tools#

This document describes the general dependencies for the image creation tools and the steps to install them.


ukify#

  1. Install all the required dependencies for ukify:

sudo apt install git python3 python3-cryptography python3-pefile python3-pillow \
  python3-setuptools libssl-dev libzstd-dev uuid-dev gnu-efi python3-packaging \
  libelf-dev lz4 pkg-config meson ninja-build
  1. Clone the systemd repository for ukify, and then check out the version you want:

git clone https://github.com/systemd/systemd.git
cd systemd
git checkout v255
  1. Install ukify by copying the ukify.py script to a directory in your PATH:

cd src/ukify
sudo cp ukify.py /usr/local/bin/ukify
  1. For environments that require ukify in /usr/bin (e.g., OS Image Composer build systems), copy it to /usr/bin

sudo cp /usr/local/bin/ukify /usr/bin/ukify
  1. Verify the installation by running the following command:

ukify --help

You should see the usage instructions for ukify.


mmdebstrap#

  1. Download the mmdebstrap package:

wget http://archive.ubuntu.com/ubuntu/pool/universe/m/mmdebstrap/mmdebstrap_1.4.3-6_all.deb
  1. Install the package:

sudo dpkg -i mmdebstrap_1.4.3-6_all.deb
  1. If dpkg reports missing dependencies, you can try to automatically resolve them using this command:

sudo apt --fix-broken install