Chapter 4. Adding packages during image creation by Using Red Hat Image Builder

You can customize your images during the creation process by adding additional packages from the BaseOS and AppStream RHEL repositories, through the UI. With that, you do not need to install the desired packages on first boot, which can be error-prone.

4.1. Adding additional packages during the image creation

When creating a customized image using Image Builder, you can add additional packages from the BaseOS and AppStream repositories. Follow the steps in this procedure to add additional packages while creating your customized RHEL 8.3 system image, using Red Hat Image Builder.


  • You have an account on Red Hat Customer Portal with an Insights subscription.
  • Access to the Red Hat Image Builder dashboard.
  • You have already completed the following steps:

    • Image output
    • Target cloud environment
    • Optionally, Registration


  1. In the Additional Package window:

    1. Type the name of the package you want to add to your image in the Available options search bar.

      Optionally, you can enter the first two letters of the package name to see the available package options. The packages are listed on the Available options dual list box.

    2. Click the package or packages you want to add.

      1. Click the >> button to add all packages shown in the package search results to the Chosen options dual list box.

        Optionally, you can click the > button to add all selected packages.

    3. Once you have finished adding the additional packages, click Next.
  2. In the Review window, review the image creation details. You can verify the list of packages you have added.
  3. Once you finish the review, click Create image to start the image creation process.
  4. Red Hat Image Builder starts the compose of a RHEL 8.3 image for the x86_64 architecture and uploads it to the target cloud environment of your choice.

    The Red Hat Image Builder Images dashboard opens. You can see details such as the Image UUID, the cloud target environment, the image OS release and the status of the image creation. Once the status is Ready, it shares the customized RHEL 8.3 system image with the specified account.

    Possible statuses:

    • Pending: the image upload and cloud registration is being processed.
    • In Progress: the image upload and cloud registration is ongoing.
    • Ready: the image upload and cloud registration is completed
    • Failed: the image upload and cloud registration failed.


      The image build, upload and cloud registration processes can take up to ten minutes to complete.