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.

Important

The foremanctl deployment utility is a Technology Preview feature only. Technology Preview features are not supported by Foreman community. Foreman community does not recommend using them in production. These features provide early access to upcoming product features, enabling customers to test functionality and provide feedback during the development process.

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.

  • Enable the required repositories:

    # dnf copr enable @theforeman/foremanctl rhel-9-x86_64

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