Skip to main content
Redhat Developers  Logo
  • 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 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

    • OpenShift AI learning
    • 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.
    • Explore the solution
  • 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

    • Access product downloads to start building and testing right away.
    • 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.
    • Explore the benefits

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

    • Trusted software factory: Building trust in the agentic AI era

    • Build a zero trust AI pipeline with OpenShift and RHEL CVMs

    • Red Hat Hardened Images: Top 5 benefits for software developers

    • How EvalHub manages two-layer Kubernetes control planes

    • Tekton joins the CNCF as an incubating project

    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 LinkedIn YouTube Twitter Facebook

    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

    Chat Support

    Please log in with your Red Hat account to access chat support.