Chapter 2. Setting up RHEL image builder

download PDF

Use RHEL image builder to create your customized RHEL for Edge images. After you install RHEL image builder on a RHEL system, RHEL image builder is available as an application in RHEL web console. You can also access RHEL image builder through a command line interface in the composer-cli tool.


It is recommended to install RHEL image builder on a virtual machine.

2.1. Image builder system requirements

The environment where RHEL image builder runs, for example a virtual machine, must meet the requirements that are listed in the following table.


Running RHEL image builder inside a container is not supported.

Table 2.1. Image builder system requirements


Minimal Required Value

System type

A dedicated virtual machine


2 cores


4 GiB

Disk space

20 GiB

Access privileges

Administrator level (root)


Connectivity to Internet


The 20 GiB disk space requirement is enough to install and run RHEL image builder in the host. To build and deploy image builds, you must allocate additional dedicated disk space.

2.2. Installing RHEL image builder

To install RHEL image builder on a dedicated virtual machine, follow these steps:


  • The virtual machine is created and is powered on.
  • You have installed RHEL and you have subscribed to RHSM or Red Hat Satellite.
  • You have enabled the BaseOS and AppStream repositories to be able to install the RHEL image builder packages.


  1. Install the following packages on the virtual machine.

    • osbuild-composer
    • composer-cli
    • cockpit-composer
    • bash-completion
    • firewalld
    # yum install osbuild-composer composer-cli cockpit-composer bash-completion firewalld

    RHEL image builder is installed as an application in RHEL web console.

  2. Reboot the virtual machine
  3. Configure the system firewall to allow access to the web console:

    # firewall-cmd --add-service=cockpit && firewall-cmd --add-service=cockpit --permanent
  4. Enable RHEL image builder.

    # systemctl enable osbuild-composer.socket cockpit.socket --now

    The osbuild-composer and cockpit services start automatically on first access.

  5. Load the shell configuration script so that the autocomplete feature for the composer-cli command starts working immediately without reboot:

    $ source /etc/bash_completion.d/composer-cli

Additional resources

Red Hat logoGithubRedditYoutubeTwitter


Try, buy, & sell


About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

© 2024 Red Hat, Inc.