Quick Start#

This guide walks you through building your first image in three steps. For full build options (Earthly, Debian package) and prerequisite details, see the Installation Guide. To check general prerequisites, go to Prerequisites, and for the practical guide on common ICT workflows, refer to Usage Guide.

To build images from the web UI in a Docker container instead, with nothing but Docker installed, see the Web UI Quick Start. To build from the command line in a Docker container, see the CLI Quick Start (Docker).

Build and Run#

  1. Clone and build (requires Go 1.24+)

git clone https://github.com/open-edge-platform/image-composer-tool.git
cd image-composer-tool
go build -buildmode=pie -ldflags "-s -w" ./cmd/image-composer-tool

Alternatively, run it directly without building a binary:

go run ./cmd/image-composer-tool --help

  1. Install the required system tools:

sudo apt install systemd-ukify mmdebstrap

  1. Compose an image using one of the templates:

sudo -E ./image-composer-tool build image-templates/azl3/azl3-x86_64-edge-raw.yml