This guide describes the quickest way to get a Foreman server up and running. For a full installation guide, see Installing Foreman Server 3.16 on Enterprise Linux.

1. System requirements

The following list shows the most critical requirements common for most scenarios. For a full list, see Installing Foreman Server 3.16 on Enterprise Linux.

  • The following operating system is supported for deploying Foreman:

    • Enterprise Linux 9 (x86_64)

  • Installing Foreman on a system with Extra Packages for Enterprise Linux (EPEL) is not supported.

  • Install Foreman server on a freshly provisioned system that serves no other function except to run Foreman server.

  • Ensure the system has at least 4 GB of memory.

2. Configuring repositories

Procedure

  1. Clear any metadata:

    # dnf clean all

  2. Install the foreman-release.rpm package:

    # dnf install https://yum.theforeman.org/releases/3.16/el9/x86_64/foreman-release.rpm

  3. Install the puppet-release package.

    • For Puppet 8:

      # dnf install https://yum.puppet.com/puppet8-release-el-9.noarch.rpm

    • For Puppet 7:

      # dnf install https://yum.puppet.com/puppet7-release-el-9.noarch.rpm
Verification

  • Verify that the required repositories are enabled:

    # dnf repolist enabled

3. Installing Foreman server packages

Procedure

  1. Upgrade all packages:

    # dnf upgrade

  2. Install the packages:

    # dnf install foreman-installer

4. Running the Foreman installer

The Foreman installer is a collection of Puppet modules that installs Foreman based on native operating system packages.

The installation run is non-interactive by default. The script displays its progress and writes logs to /var/log/foreman-installer/foreman.log.

Procedure

  • Run the Foreman installer:

    # foreman-installer

    For a list of the available customization options, run foreman-installer --help or foreman-installer --full-help.

Report issue