The Foreman installer is a collection of Puppet modules that installs everything required for a full working Foreman setup. It uses native OS packaging (.rpm or .deb packages) and adds necessary configuration for the complete installation.

Components include the Foreman web UI, Smart Proxy, a Puppet server, TFTP, DNS and DHCP servers. It is configurable and the Puppet modules can be read or run in "no-op" mode to see what changes it will make.

Supported operating systems

The following operating systems are supported by the installer, have packages, and are tested for deploying Foreman:

Table 1. Operating systems supported by foreman-installer

Operating System

Architecture

Notes

Enterprise Linux 8

x86_64 only

EPEL is not supported.

Foreman community advises against using an existing system because the Foreman installer will affect the configuration of several components.

The installation will require 4GB of memory. For more information, see System Requirements.

The Foreman installer uses Puppet to install Foreman. This guide assumes that you have a newly installed operating system, on which the installer will setup Foreman, a Puppet server, and the Smart Proxy by default.

1. Configuring repositories

Use these procedures to enable the repositories required to install Foreman server.

Choose from the following list which operating system and version you are installing on:

1.1. CentOS Stream 8

  1. Clear any metadata:

    # dnf clean all
  2. Install the foreman-release.rpm package:

    # dnf install https://yum.theforeman.org/releases/3.9/el8/x86_64/foreman-release.rpm
  3. Install the katello-repos-latest.rpm package:

    # dnf install https://yum.theforeman.org/katello/4.11/katello/el8/x86_64/katello-repos-latest.rpm
  4. Install the puppet7-release-el-8.noarch.rpm package:

    # dnf install https://yum.puppet.com/puppet7-release-el-8.noarch.rpm
  5. Enable powertools repository:

    # dnf config-manager --set-enabled powertools
  6. Enable the DNF modules:

    # dnf module enable katello:el8

1.2. Red Hat Enterprise Linux 8

  1. Disable all repositories:

    # subscription-manager repos --disable "*"
  2. Enable the following repositories:

    # subscription-manager repos --enable=rhel-8-for-x86_64-baseos-rpms \
    --enable=rhel-8-for-x86_64-appstream-rpms
  3. Clear any metadata:

    # dnf clean all
  4. Install the foreman-release.rpm package:

    # dnf install https://yum.theforeman.org/releases/3.9/el8/x86_64/foreman-release.rpm
  5. Install the katello-repos-latest.rpm package:

    # dnf install https://yum.theforeman.org/katello/4.11/katello/el8/x86_64/katello-repos-latest.rpm
  6. Install the puppet7-release-el-8.noarch.rpm package:

    # dnf install https://yum.puppet.com/puppet7-release-el-8.noarch.rpm
  7. Enable the DNF modules:

    # dnf module enable katello:el8
    Note

    If there is any warning about conflicts with Ruby or PostgreSQL while enabling katello:el8 module, see Troubleshooting DNF modules in Installing Foreman Server with Katello 4.11 Plugin on CentOS/RHEL. For more information about modules and lifecycle streams on Red Hat Enterprise Linux 8, see Red Hat Enterprise Linux Application Streams Lifecycle.

2. Installing Foreman server packages

Procedure
  1. Update all packages:

    # dnf update
  2. Install foreman-installer-katello:

    # dnf install foreman-installer-katello

3. Running the Installer

The installation run is non-interactive, but the configuration can be customized by supplying any of the options listed in foreman-installer --help, or by running foreman-installer -i for interactive mode. More examples are given in the Installation Options section. Adding -v will disable the progress bar and display all changes.

To run the installer, execute:

# foreman-installer --scenario katello

When the installer has completed, details will be printed about where to find Foreman and the Smart Proxy.