Este contenido no está disponible en el idioma seleccionado.

Chapter 6. Creating system images by using RHEL image builder web console interface


RHEL image builder is a tool for creating custom system images. To control RHEL image builder and create your custom system images, you can use the web console interface.

With the cockpit-image-builder plugin for the RHEL web console, you can manage image builder blueprints and composes by using a graphical interface.

Prerequisites

  • You must have root access to the system.
  • You installed RHEL image builder.
  • You installed the cockpit-image-builder package.

Procedure

  1. On the host, open https://localhost:9090/ in a web browser.
  2. Log in to the web console as the root user.
  3. To display the RHEL image builder controls, click the Image Builder button, in the upper-left corner of the window.

    The RHEL image builder dashboard opens, listing existing blueprints, if any.

6.2. Creating a blueprint in the web console interface

Before creating your customized RHEL system image, you must create a blueprint. All customizations are optional.

Prerequisites

Procedure

  1. Click Create Blueprint. On the Image output page, select Release version, Architecture, and target environment, then click Next.
  2. Optional: On the File system configuration page, select Manually configure partitions to add mount points, such as /var, /home, /tmp and specify Minimum size partition. Click Next.
  3. Optional: On the Additional packages page, search for packages, move them to Chosen packages, then click Next.
  4. Optional: On the Users page, click Add user to enter a Username, a Password, an SSH key, and Administrator privileges. Click Next
  5. Optional: On the Timezone page, enter a time zone, for example, "US/Eastern" and NTP servers. Click Next.
  6. Optional: On the Locale page, enter the languages and keyboard identifier. For example: "us" and ["en_US.UTF-8"]. Click Next.
  7. Optional: On the Hostname and Kernel pages, add a hostname, and kernel command-line arguments. Click Next after each page.
  8. Optional: On the Firewall and Systemd services pages, configure port, firewall services, and systemd services to enable or disable. Click Next after each page.
  9. On the Details page, enter the blueprint name and optional description, then click Next.
  10. On the Review page, review the details and click Create blueprint or Create blueprint and build image(s).

You can import and use an already existing blueprint. The system automatically resolves all the dependencies.

Prerequisites

  • You have opened the RHEL image builder app from the web console in a browser.
  • You have a blueprint that you want to import to use in the RHEL image builder web console interface.

Procedure

  1. On the RHEL image builder dashboard, click Import blueprint. The Import blueprint wizard opens.
  2. From the Upload field, either drag or upload an existing blueprint. This blueprint can be in either TOML or JSON format.
  3. Click Import. The dashboard lists the blueprint you imported.

Verification

When you click the blueprint you imported, you have access to a dashboard with all the customizations for the blueprint that you imported.

  • To verify the packages that have been selected for the imported blueprint, navigate to the Packages tab.

    • To list all the package dependencies, click All. The list is searchable and can be ordered.

Next steps

  • Optional: To modify any customization:

    • From the Customizations dashboard, click the customization you want to make a change to. Optionally, you can click Edit blueprint to navigate to all the available customization options.

You can export a blueprint to use the customizations in another system. You can export the blueprint in the TOML or in JSON format. Both formats work on the CLI and also in the API interface.

Prerequisites

  • You have opened the RHEL image builder app from the web console in a browser.
  • You have a blueprint that you want to export.

Procedure

  1. On the image builder dashboard, select the blueprint you want to export.
  2. Click Export blueprint. The Export blueprint wizard opens.
  3. Click the Export button to download the blueprint as a file or click the Copy button to copy the blueprint to the clipboard.

    1. Optional: Click the Copy button to copy the blueprint.

Verification

  • Open the exported blueprint in a text editor to inspect and review it.

You can create a customized RHEL system image from a customized blueprint by completing these steps.

Prerequisites

  • You opened the RHEL image builder app from the web console in a browser.
  • You created a blueprint.

Procedure

  1. In the RHEL image builder dashboard, click the blueprint tab.
  2. On the blueprint table, find the blueprint you want to build an image.
  3. On the right side of the chosen blueprint, click Create Image. The Create image dialog wizard opens.
  4. On the Image output page, complete the following steps:

    1. From the Select a blueprint list, select the image type you want.
    2. From the Image output type list, select the image output type you want.

      Depending on the image type you select, you need to add further details.

  5. Click Next.
  6. On the Review page, review the details about the image creation and click Create image.

    The image build starts and takes up to 20 minutes to complete.

Verification

After the image finishes building, you can:

  • Download the image.

    • On the RHEL image builder dashboard, click the Node options (⫶) menu and select Download image.
  • Download the logs of the image to inspect the elements and verify if any issue is found.

    • On the RHEL image builder dashboard, click the Node options (⫶) menu and select Download logs.
Red Hat logoGithubredditYoutubeTwitter

Aprender

Pruebe, compre y venda

Comunidades

Acerca de la documentación de Red Hat

Ayudamos a los usuarios de Red Hat a innovar y alcanzar sus objetivos con nuestros productos y servicios con contenido en el que pueden confiar. Explore nuestras recientes actualizaciones.

Hacer que el código abierto sea más inclusivo

Red Hat se compromete a reemplazar el lenguaje problemático en nuestro código, documentación y propiedades web. Para más detalles, consulte el Blog de Red Hat.

Acerca de Red Hat

Ofrecemos soluciones reforzadas que facilitan a las empresas trabajar en plataformas y entornos, desde el centro de datos central hasta el perímetro de la red.

Theme

© 2026 Red Hat
Volver arriba