Skip to content


Switch branches/tags


Failed to load latest commit information.
Latest commit message
Commit time


Setting up Foreman for provisioning can be daunting at first, as there are lots of parameters to configure DHCP and DNS for the installer, plus for setup of subnets, domains, installation media etc for Foreman.


Please see the Foreman wiki for appropriate instructions:

The gem name is "foreman_setup". Run foreman-rake db:migrate after installation.

RPM users can install the "tfm-rubygem-foreman_setup" or "rubygem-foreman_setup" packages.


Foreman Version Plugin Version
<= 1.4 ~> 1.0
>= 1.5 ~> 2.0
>= 1.9 ~> 3.0
>= 1.12 ~> 4.0
>= 1.13 ~> 5.0
>= 1.17 ~> 6.0
>= 1.22 ~> 7.0
>= 3.2 ~> 8.0

Areas this should help

  • take input of subnet and domain information
  • output foreman-installer command with appropriate DHCP, DNS and TFTP parameters
  • add foreman-installer modules to the Foreman host with appropriate parameters
  • create a host group with appropriate parameters
  • create hosts (proxies/nodes) using created host groups
  • ensure provided templates and OSes are fully associated
    • default templates should be properly associated in core
    • when using Katello, its Foreman plugin helps associate
  • add appropriate installation media
  • add appropriate Spacewalk/redhat_register parameters


Copyright (c) 2013 Red Hat Inc.

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see