Skip to main content
AI
  • Get started with AI

    • Red Hat AI

      Accelerate the development and deployment of enterprise AI solutions.

    • AI learning hub

      Explore learning materials and tools, organized by task.

    • AI interactive demos

      Click through scenarios with Red Hat AI, including training LLMs and more.

    • AI/ML learning paths

      Expand your Red Hat OpenShift AI knowledge using these learning resources.

    • AI quickstarts

      Focused AI use cases designed for fast deployment on Red Hat AI platforms.

    • No-cost AI training

      Foundational Red Hat AI training.

  • Featured resources

    • Red Hat OpenShift AI
    • Open source AI for developers
    • AI product application development
    • Open source-powered AI/ML for hybrid cloud
    • AI and Node.js cheat sheet

Red Hat AI Factory with NVIDIA

Red Hat AI Factory with NVIDIA is a co-engineered, enterprise-grade AI solution for building, deploying, and managing AI at scale across hybrid cloud environments.

Learn
  • Self-guided

    • Documentation

      Find answers, get step-by-step guidance, and learn how to use Red Hat products.

    • Learning paths

      Explore curated walkthroughs for common development tasks.

    • Guided learning

      Receive custom learning paths powered by our AI assistant.

    • See all learning
  • Hands-on

    • Developer Sandbox

      Spin up Red Hat's products and technologies without setup or configuration.

    • Interactive labs

      Learn by doing in these hands-on, browser-based experiences.

    • Interactive demos

      Click through product features in these guided tours.

  • Browse by topic

    • AI/ML
    • Automation
    • Java
    • Kubernetes
    • Linux
    • See all topics
  • Training & certifications

    • Courses and exams
    • Certifications
    • Skills assessments
    • Red Hat Academy
    • Learning subscription
    • Explore training
Build
  • Get started

    • Red Hat build of Podman Desktop

      A downloadable, local development hub to experiment with our products and builds.

    • Developer Sandbox

      Spin up Red Hat's products and technologies without setup or configuration.

  • Download products

    • Red Hat Enterprise Linux
    • Red Hat AI
    • Red Hat OpenShift
    • Red Hat Ansible Automation Platform
    • See all products
  • Featured

    • Red Hat build of OpenJDK
    • Red Hat JBoss Enterprise Application Platform
    • Red Hat OpenShift Dev Spaces
    • Red Hat Developer Toolset
  • References

    • E-books
    • Documentation
    • Cheat sheets
    • Architecture center
Community
  • Get involved

    • Events
    • Live AI events
    • Red Hat Summit
    • Red Hat Accelerators
    • Community discussions
  • Follow along

    • Articles & blogs
    • Developer newsletter
    • Videos
    • Github
  • Get help

    • Customer service
    • Customer support
    • Regional contacts
    • Find a partner

Join the Red Hat Developer program

Download Red Hat products and project builds, access support documentation, learning content, and more.

ConsoleDocsSupport Search
New For you

Recommended

We'll recommend resources you may like as you browse. Try these suggestions for now.

  • Product downloads
  • Cheat sheets
  • Red Hat Developer learning portal
  • Developer blog
  • E-books
  • Developer Sandbox
Log in

Get more with a Red Hat Developer account

  • Product downloads
  • Console access
  • Event registration
  • Training & trials
Explore more account benefitsLog in or register

A subscription may be required for some services.

Contact us

How RHEL image builder complements your existing workflow

May 16, 2023
Alessandro Rossi
Related topics:
ContainersLinux
Related products:
Red Hat Enterprise Linux

    Managing heterogeneous environments can be challenging and enterprises are always implementing more elaborated workflows to support standardization across multiple infrastructures and platforms. 

    With Red Hat Enterprise Linux and Red Hat Lightspeed (formerly Red Hat Insights), a feature that can support this process comes out of the box: image builder. In this article, we will go through the core capabilities and demonstrate how easy it is to start building the first image from scratch.

    Getting started with RHEL image builder

    Image builder is an available tool for Red Hat Enterprise Linux (RHEL) that allows users to customize and build their own image that can be used on either hypervisors or cloud providers, or built as an ISO installer to provision systems at scale using Anaconda and Kickstart for unattended installations.

    The image builder is based on the osbuild-composer upstream project and is available in RHEL as an installable package. It also offers integration with the RHEL web console, which simplifies and enables a visual way of composing and creating images.

    On a fresh system, both the web console and the image builder plug-ins can be easily installed:

    sudo dnf install -y osbuild-composer composer-cli cockpit cockpit-composer

    And enabling the respective services:

    sudo systemctl enable –now cockpit cockpit.socket osbuild-composer.socket

    After enabling the socket, it is possible to restart the osbuild-composer service:

    sudo systemctl restart osbuild-composer

    After these steps, the web console will be enabled on port 9090 of your server and you can access it with your browser, as shown in Figure 1.

    RHEL Web Console Image builder empty section
    Figure 1: Image Builder section on RHEL Web Console.

    As an alternative, the image builder is also available on Red Hat Hybrid Cloud Console as a service, but in this article we will focus on the bundled version available on RHEL. See Figure 2.

    Red Hat Lightspeed page for Image Builder
    Figure 2: Image Builder integration on Red Hat Lightspeed.

    What does an image look like?

    When creating an image, many aspects should be considered, such as:

    • The purpose of the image
    • Where it will be deployed
    • The packages that we want to ship with it
    • The services that will be available and running in the end system
    • Users authentication

    All these aspects can be customized in a centralized way using the image builder blueprints. Figure 3 depicts this feature.

    Blueprints are used as a skeleton for images we will build and come with a great set of customizable options that we can use to craft the resulting image, such as:

    • Kernel versions and options
    • Storage configuration and partitioning
    • Packages and services, including custom repositories
    • User management (users, group, SSH configuration)
    Configuration modal window to create image blueprint
    Figure 3: Blueprint customization step-by-step.

    Customizing the blueprint

    Once the blueprint is in place, the image builder plug-in for the RHEL web console provides a comprehensive section where we can further customize the blueprint and it will track all the customizations.

    In this specific case we are creating the golden image for a service hosting a simple LAMP application, configuring the required packages, services, and firewall rules to start using the stack right from the first boot without further intervention, as shown in Figure 4.

    Summary page on RHEL Web Console showing image customizations
    Figure 4: Image details on RHEL Web Console.

    The resulting blueprint is also available using the command-line interface composer-cli that is available as part of the packages we install.

    On the system, running the following command will allow us to review the TOML version of the blueprint, which contains all the customization we added up to now:

    sudo composer-cli blueprints show my_golden_image

    The output will produce the content of the blueprint and its customizations:

    name = "my_golden_image"
    description = ""
    version = "0.0.0"
    modules = []
    groups = []
    distro = ""
    [[packages]]
    name = "firewalld"
    [[packages]]
    name = "httpd"
    [[packages]]
    name = "php"
    [customizations]
    [[customizations.user]]
    name = "myadmin"
    password = "SHA256-password"
    groups = ["wheel"]
    [[customizations.group]]
    name = "super_admin"
    [customizations.timezone]
    [customizations.locale]
    [customizations.firewall]
    [customizations.firewall.services]
    enabled = ["http", "https"]
    [customizations.services]
    enabled = ["httpd", "mariadb", "firewalld"]
    [[customizations.filesystem]
    mountpoint = "/"
    size = 10106127360

    Building the golden image

    Once we define and customize the blueprint for our image, we are then ready to choose the format for our image (hypervisor, ISO, cloud image) and start building it.

    Image builder offers many output formats for images, including the following, among others:

    • Cloud providers (AWS, Azure, Google Cloud, and Oracle Cloud)
    • Hypervisors (OpenStack KVM, QEMU, VSphere)
    • RHEL for edge installer, container, and ostree commits

    From the blueprint configuration page we can click Create Image and select the desired format for our golden image we will use for our servers and create it, as shown in Figure 6.

    Modal window to generate the image with parameters
    Figure 5: Image creation wizard on RHEL Web Console.

    The interface will provide us with the building status and once the image is ready it will be possible to download and start using it. See Figure 7.

    Image builder page showing image creation status
    Figure 6: Image creation status on RHEL Web Console.

    Integrations

    All the commands we issued using the web console can be replicated using the composer-cli utility or integrating external tools with the osbuild-composer APIs making it extremely easy and versatile to bring image building, definition and QA using automation on third-party utilities.

    When it comes to Red Hat Ansible Automation Platform integrations, dedicated validated content for osbuild is available and supported to start automating image customization and building directly into existing workflows or by creating dedicated automation for them.

    When it comes to the image builder service available on the Red Hat Hybrid Cloud Console, APIs are available as well and ready to be integrated.

    Conclusion

    Red Hat image builder is a great tool to start standardizing and providing consistent content across heterogeneous environments.

    You can create and build images as well as introduce the building process as part of a workflow when releasing new versions of your custom images for your workloads or your servers and devices.

    If you are interested in learning more, don’t hesitate to contact us!

    Additional resources

    • Composing a customizable image with RHEL Image builder documentation
    • Build a golden image for your RHEL homelab with Image Builder
    • Using hosted image builder via its API
    • Self-paced interactive lab
    Last updated: November 5, 2025

    Related Posts

    • What's new in Red Hat Enterprise Linux 9.4?

    • How RHEL image builder has improved security and function

    • Customize AWS cloud images with RHEL image builder and Packit

    • Red Hat Enterprise Linux 8 Image Builder: Building custom system images

    • What’s new in vSphere on RHEL image builder

    • Customize AWS cloud images with RHEL image builder and Packit

    Recent Posts

    • Run Red Hat Enterprise Linux CoreOS on NVIDIA BlueField DPUs

    • Agent harness engineering: Separating model capabilities from enforcement

    • What's new for developers in Red Hat Enterprise Linux 10.3 and 9.9

    • Control multicluster costs with right-sizing in Red Hat Advanced Cluster Management 5

    • Lightbits is now certified for Red Hat OpenStack Services on OpenShift

    What’s up next?

    This cheat sheet covers the use of Red Hat Lightspeed APIs to obtain system details and findings, as well as to interact with specific Red Hat Lightspeed applications.

    Get the cheat sheet
    Red Hat Developers logo

    Platforms

    • Red Hat AI
    • Red Hat Enterprise Linux
    • Red Hat OpenShift
    • Red Hat Ansible Automation Platform
    • See all products

    Build

    • Developer Sandbox
    • Developer tools
    • Interactive tutorials
    • API catalog

    Quicklinks

    • Learning resources
    • E-books
    • Cheat sheets
    • Blog
    • Events
    • Newsletter

    Communicate

    • About us
    • Contact sales
    • Find a partner
    • Report a website issue
    • Site status dashboard
    • Report a security problem

    Red Hat Developer

    Build here. Go anywhere.

    We serve the builders. The problem solvers who create careers with code.

    Join us if you’re a developer, software engineer, web designer, front-end designer, UX designer, computer scientist, architect, tester, product manager, project manager or team lead.

    Sign me up

    Red Hat legal and privacy links

    • About Red Hat
    • Jobs
    • Events
    • Locations
    • Contact Red Hat
    • Red Hat Blog
    • Inclusion at Red Hat
    • Cool Stuff Store
    • Red Hat Summit
    © 2026 Red Hat

    Red Hat legal and privacy links

    • Privacy statement
    • Terms of use
    • All policies and guidelines
    • Digital accessibility
    Ask AI