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

  • 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

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/3.19/el9/x86_64/foreman-release.rpm

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

    # dnf install https://yum.theforeman.org/katello/4.21/katello/el9/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.

Report issue