Chapter 11. Installing Red Hat Update Infrastructure

Once you have completed the prerequisites, you can install RHUI on your system. You can install RHUI using repositories and a network connection to resolve dependencies.

11.1. Installing Red Hat Update Infrastructure using repositories

Perform the following steps to install Red Hat Update Infrastructure (RHUI) on your system using repositories.


  • Ensure that your system can access the internet.
  • Ensure you have root access to the RHUA node.


  1. Navigate to the RHUA node and install the rhui-installer package.

    # dnf install rhui-installer
  2. Run the installer and specify the arguments based on your use case.

    Note that the following arguments are mandatory:

    • --remote-fs-server: The remote mountpoint for the shared file system.
    • --cds-lb-hostname: The name of the load balancer that clients use to access the CDS. You must specify the name as a fully qualified domain name (FQDN).
    • --rhua-hostname: The hostname of the RHUA node. You must specify the name as a fully qualified domain name (FQDN).


      The rhui-installer sets the initial RHUI login password by default and stores it in the /etc/rhui/rhui-subscription-sync.conf file.

      If you wish to set your own password, you can override the initial password with the --rhui-manager-password argument.

      # rhui-installer --remote-fs-server <nfs_server>:/ --rhua-hostname <public-hostname-of-your-rhua> --cds-lb-hostname <public-hostname-of-your-cds-or-lb>


  • On the RHUA node, verify if you can access the RHUI Terminal User Interface (TUI).

    # rhui-manager