Image Builder on Fedora Workstation 38

Image builder installation on Fedora 38

by

Image Builder is a tool that allows you to create custom Fedora OS images. You can use the command line or a Cockpit plugin to work with Image Builder.

Prerequisites

Image Builder Installation

Install Image Builder using below command

sudo dnf install -y osbuild-composer composer-cli cockpit-composer

Enable osbuild-composer.socket

sudo systemctl enable --now osbuild-composer.socket

To run the composer-cli commands as non-root, user must be in the weldr or root groups.

The newgrp command changes a user’s real group identification. When you run the command, the system places you in a new shell and changes the name of your real group to the group specified with the Group parameter

sudo usermod -a -G weldr $USER
newgrp weldr

Blueprint manipulation

List all available blueprints composer-cli blueprints list
Show a blueprint contents in the TOML format composer-cli blueprints show BLUEPRINT-NAME
Save (export) blueprint contents in the TOML format into a file BLUEPRINT-NAME.toml composer-cli blueprints save BLUEPRINT-NAME
Remove a blueprint composer-cli blueprints delete BLUEPRINT-NAME
Push (import) a blueprint file in the TOML format into Image Builder composer-cli blueprints push BLUEPRINT-NAME.toml

ย Composing images from blueprints

List the available image types composer-cli compose types
Start a compose composer-cli compose start BLUEPRINT COMPOSE-TYPE
List all composes composer-cli compose list
List all composes and their status composer-cli compose status
Show detailed information about a compose composer-cli compose info COMPOSE-UUID
Download image file of a compose composer-cli compose image COMPOSE-UUID
Check whether the components and versions listed in the blueprint and their dependencies are valid composer-cli blueprints depsolve BLUEPRINT-NAME