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

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

  • The following operating systems are supported for deploying Foreman:

    • Enterprise Linux 9 (x86_64)

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

Enable the necessary repositories on your Foreman host to access installation packages and dependencies.

Procedure

  1. Clear any metadata:

    # dnf clean all

  2. Install the foreman-release.rpm package:

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

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