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 (containerized) 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)

  • Enterprise Linux 10 (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.

Procedure

  1. Clear any metadata:

    # dnf clean all

  • Enterprise Linux 9

  • Enterprise Linux 10

  1. Install the foreman-release.rpm package:

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

  2. Install the katello-repos-latest.rpm package:

    # dnf install https://yum.theforeman.org/katello/nightly/katello/el9/x86_64/katello-repos-latest.rpm

  1. Install the foreman-release.rpm package:

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

  2. Install the katello-repos-latest.rpm package:

    # dnf install https://yum.theforeman.org/katello/nightly/katello/el10/x86_64/katello-repos-latest.rpm
Verification

  • 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.

Procedure

  1. Upgrade all packages:

    # dnf upgrade

  2. Install the foremanctl package:

    # dnf install foremanctl

  3. Deploy the configuration on your server:

    # foremanctl deploy

    You can find credentials to access your Foreman server in the message shown in the TASK [post_install : Admin credentials] task results.

    For a list of available options, run foremanctl --help.

Pre-release version Report issue