This guide describes the quickest way to get a Foreman server up and running. For a full installation guide, see Installing Foreman Server with Katello nightly plugin on Enterprise Linux.
1. System requirements for Foreman
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 20 GB of memory.
2. Configuring repositories for Foreman
Enable the necessary repositories on your Foreman host to access installation packages and dependencies.
-
Clear any metadata:
# dnf clean all
-
Install the
foreman-release.rpmpackage:# dnf install https://yum.theforeman.org/releases/nightly/el9/x86_64/foreman-release.rpm
-
Install the
katello-repos-latest.rpmpackage:# dnf install https://yum.theforeman.org/katello/nightly/katello/el9/x86_64/katello-repos-latest.rpm
-
Install the
openvox-releasepackage:# dnf install https://yum.voxpupuli.org/openvox8-release-el-9.noarch.rpm
-
Verify that the required repositories are enabled:
# dnf repolist enabled
3. Running the Foreman deployment utility
Install the required packages and run the Foreman deployment utility.
-
Upgrade all packages:
# dnf upgrade
-
Install foreman-installer-katello:
# dnf install foreman-installer-katello
-
Run the Foreman installer:
# foreman-installer --scenario katello
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.
For a list of the available customization options, run
foreman-installer --helporforeman-installer --full-help.