Chapter 7. Configuring Satellite to provision from a Red Hat Image Builder image


In Satellite, you can enable integration with the RHEL web console to perform actions and monitor your hosts. Using the RHEL web console, you can access Red Hat Image Builder and build images. Afterwards, you can use these images to provision hosts.

Additional resources

You can upload a Red Hat Image Builder image to Satellite and use this image to provision hosts by using network boot.

When you provision from a Red Hat Image Builder image, Anaconda installer partitions disks, downloads and mounts the image, and copies files over to a host.

Prerequisites

  • An existing TAR image created by using Red Hat Image Builder in the RHEL web console. Ensure that your blueprint to build the image includes the required packages.
  • If you want to use Capsule Server URL, then the referenced lifecycle environment, such as Library, must be synchronized to that Capsule Server. For more information, see Adding lifecycle environments to Capsule Servers in Installing Capsule Server.

Procedure

  1. On Satellite, create a custom product, add a custom file type repository to this product, and upload the image to the repository. For more information, see Importing individual ISO images and files in Managing content.
  2. In the Satellite web UI, navigate to Configure > Host Groups.
  3. Select the host group that you want to use.
  4. Click the Parameters tab, and then click Add Parameter.
  5. Create a parameter named kickstart_liveimg with type string and set the value to the full URL of the image location or the file name of the image inside a published content view, for example:

    • Full URL: https://capsule.example.com/pulp/content/My_Organization_Label/Library/custom/My_Product_Label/My_Repository_Label/My_Image_Name.tar
    • Image file name: My_Image_Name.tar

      You can use the image file name only if the host is subscribed to a single content view and lifecycle environment, and the kt_activation_keys parameter is defined for the host. The content view must be published.

      If a content source is assigned to the host, Satellite will use the content source Capsule of the host. If a content source is not assigned, Satellite will use Satellite Server.

  6. Click Submit to save your changes.

You can upload a Red Hat Image Builder image to an HTTP server and use this image to provision hosts by using network boot.

When you provision from a Red Hat Image Builder image, Anaconda installer partitions disks, downloads and mounts the image, and copies files over to a host.

Prerequisites

  • An existing TAR image created by using Red Hat Image Builder in the RHEL web console. Ensure that your blueprint to build the image includes the required packages.

Procedure

  1. Copy the image to an existing HTTP server that your hosts can reach.
  2. In the Satellite web UI, navigate to Configure > Host Groups.
  3. Select the host group that you want to use.
  4. Click the Parameters tab, and then click Add Parameter.
  5. Create a parameter named kickstart_liveimg with type string and set the value to the URL of the image location, such as https://webserver.example.com/path/My_Image_Name.tar.
  6. Click Submit to save your changes.

For the use in Satellite, the Red Hat Image Builder image must contain the following minimum of packages:

  • NetworkManager
  • authselect
  • chrony
  • dnf
  • dracut
  • efibootmgr
  • firewalld
  • grub2
  • grub2-efi
  • grub2-tools-extra
  • insights-client – required only if you plan to use Insights reporting
  • iproute
  • iputils
  • kernel
  • kernel-core
  • lvm2
  • subscription-manager
  • wget
Back to top
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

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

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.

Theme

© 2025 Red Hat