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

1. System requirements

The following list shows the most critical requirements common for most scenarios.

  • 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 CPU cores and 4 GB of memory.

2. Configuring repositories

Configure the required repositories.

Procedure

  1. Clear any metadata:

    # dnf clean all

  2. Install the foreman-release.rpm package:

    # dnf install https://yum.theforeman.org/releases/nightly/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. Running the Foreman installer

Install the required packages and run the Foreman installer utility.

Procedure

  1. Upgrade all packages:

    # dnf upgrade

  2. Install foreman-installer:

    # dnf install foreman-installer

  3. Run the Foreman installer:

    # foreman-installer

    The foreman-installer 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.

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

Pre-release version Report issue