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. For that, follow the steps:


  • 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. On the Packages page:

    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. After you have finished adding the additional packages, click Next.
  2. On the Name image page, enter a name for your image and click Next. If you do not enter a name, you can find the image you created by its UUID.
  3. On the Review page, review the details about the image creation and click Create image.

    After you complete the steps in the Create image wizard, the Image Builder dashboard is displayed. Red Hat Image Builder starts the compose of a RHEL image for the x86_64 architecture.

    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.


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