Chapter 2. Installing Image Builder

Before using Image Builder, you must install Image Builder in a virtual machine.

2.1. Installing Image Builder in a virtual machine

To install Image Builder on a dedicated virtual machine, follow these steps:


  • Connect to the virtual machine.
  • The virtual machine for Image Builder must be installed, subscribed, and running.


  1. Install the Image Builder and other necessary packages on the virtual machine:

    • lorax-composer
    • composer-cli
    • cockpit-composer
    • bash-completion
    # yum install lorax-composer composer-cli cockpit-composer bash-completion

    The web console is installed as a dependency of the cockpit-composer package.

  2. Enable Image Builder to start after each reboot:

    # systemctl enable --now lorax-composer.socket
    # systemctl enable cockpit.socket

    The lorax-composer and cockpit services start automatically on first access.

  3. Configure the system firewall to allow access to the web console:

    # firewall-cmd --add-service=cockpit && firewall-cmd --add-service=cockpit --permanent
  4. Load the shell configuration script so that the autocomplete feature for the composer-cli command starts working immediately without reboot:

    $ source  /etc/bash_completion.d/composer-cli