Ce contenu n'est pas disponible dans la langue sélectionnée.

Chapter 1. RHEL image builder description


To deploy a system, create a system image. To create RHEL system images, use the RHEL image builder tool. You can use RHEL image builder to create customized system images of RHEL, including system images prepared for deployment on cloud platforms. RHEL image builder automatically handles the setup details for each output type and is therefore easier to use and faster to work with than manual methods of image creation. You can access the RHEL image builder functionalities by using the command line in the composer-cli tool, or the graphical user interface in the RHEL web console.

Note

From RHEL 8.3 onward, the osbuild-composer back end replaces lorax-composer. The new service provides REST APIs for image building.

1.1. RHEL image builder terminology

RHEL image builder uses the following concepts:

Blueprint

A blueprint is a description of a customized system image. It lists the packages and customizations that will be part of the system. You can edit blueprints with customizations and save them as a particular version. When you create a system image from a blueprint, the image is associated with the blueprint in the RHEL image builder interface.

Create blueprints in the TOML format.

Compose
Composes are individual builds of a system image, based on a specific version of a particular blueprint. Compose as a term refers to the system image, the logs from its creation, inputs, metadata, and the process itself.
Customizations
Customizations are specifications for the image that are not packages. This includes users, groups, and SSH keys.

1.2. RHEL image builder output formats

RHEL image builder can create images in multiple output formats shown in the following table.

Expand
Table 1.1. RHEL image builder output formats
DescriptionCLI nameFile extension

Architecture

Amazon Web Services

ami

[filename]`.ami

aarch64, x86_64

Disk Archive

tar

.tar

aarch64, x86_64, ppc64le, s390x

Google Cloud

gce

.tar.gz

x86_64

Microsoft Azure

vhd

.vhd

aarch64, x86_64

OpenStack

qcow2

.qcow2

aarch64, x86_64, ppc64le, s390x

Oracle Cloud Infrastructure

.oci

.qcow2

x86_64

QEMU Image

qcow2

.qcow2

aarch64, x86_64, ppc64le, s390x

RHEL Installer

image-installer

.iso

aarch64, x86_64

VMware vSphere

vmdk

.vmdk

x86_64

VMware vSphere

ova

.ova

x86_64

Vagrant

vagrant-libvirt

.qcow2

aarch64, x86_64

Windows Subsystem for Linux

wsl

.wsl

To check the supported types, run the command:

# composer-cli compose types
Copy to Clipboard Toggle word wrap

1.3. Supported architectures for image builds

RHEL image builder supports building images for the following architectures:

  • AMD and Intel 64-bit (x86_64)
  • ARM64 (aarch64)
  • IBM Z (s390x)
  • IBM POWER systems

However, RHEL image builder does not support multi-architecture builds. It only builds images of the same system architecture that it is running on. For example, if RHEL image builder is running on an x86_64 system, it can only build images for the x86_64 architecture.

Retour au début
Red Hat logoGithubredditYoutubeTwitter

Apprendre

Essayez, achetez et vendez

Communautés

À propos de la documentation Red Hat

Nous aidons les utilisateurs de Red Hat à innover et à atteindre leurs objectifs grâce à nos produits et services avec un contenu auquel ils peuvent faire confiance. Découvrez nos récentes mises à jour.

Rendre l’open source plus inclusif

Red Hat s'engage à remplacer le langage problématique dans notre code, notre documentation et nos propriétés Web. Pour plus de détails, consultez le Blog Red Hat.

À propos de Red Hat

Nous proposons des solutions renforcées qui facilitent le travail des entreprises sur plusieurs plates-formes et environnements, du centre de données central à la périphérie du réseau.

Theme

© 2026 Red Hat