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
Before installing Foreman, verify that the deployment host runs a supported operating system, is dedicated to Foreman server, and provides the minimum CPU and memory resources.
You can deploy Foreman on the following operating systems:
-
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. Configure 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.