Foreman 3.15 with Katello Installation on CentOS Stream 9

⚠️ Requirements

  • Fresh CentOS Stream 9 installation
  • Root or sudo privileges
  • At least 8 GB RAM and 2 CPUs
  • Proper FQDN (e.g., foreman.example.com)
  • Static IP recommended

🛠️ Step 1: Set Hostname

sudo hostnamectl set-hostname foreman.example.com

Edit /etc/hosts and add:

127.0.0.1   localhost
192.168.1.100  foreman.example.com foreman

🌐 Step 2: Update System

sudo dnf update -y
sudo dnf install -y epel-release

🔐 Step 3: Disable SELinux (optional but can help during install)

sudo setenforce 0
sudo sed -i 's/^SELINUX=.*/SELINUX=permissive/g' /etc/selinux/config

📦 Step 4: Install Foreman Installer

# Enable Foreman and Katello repositories
sudo dnf install -y https://yum.theforeman.org/releases/3.15/el9/x86_64/foreman-release.rpm
sudo dnf install -y https://yum.theforeman.org/katello/4.17/katello-repos-latest.el9.noarch.rpm

# Install Foreman installer
sudo dnf config-manager --set-enabled crb
sudo dnf install -y foreman-installer-katello

🚀 Step 5: Run Foreman Installer with Katello

sudo foreman-installer --scenario katello

This process may take 10–30 minutes depending on your system.

🔓 Step 6: Access Foreman

Once the installer completes, you'll see output with admin credentials like:

Admin username: admin
Admin password: <random_generated_password>

Now open your browser and access:

https://foreman.example.com

Accept the SSL certificate warning if presented.

⚙️ Optional: Enable Cockpit Web Console

sudo systemctl enable --now cockpit.socket
sudo firewall-cmd --permanent --add-service=cockpit
sudo firewall-cmd --reload

Access: https://foreman.example.com:9090

🔥 Post-Installation Tips

  • Sync repositories (Red Hat, Debian, etc.) via UI
  • Configure activation keys
  • Register clients using subscription-manager or katello-host-tools

💬 Help & Resources

✅ Done!

You have successfully installed Foreman 3.15 with Katello 4.17 on CentOS Stream 9!