Automated Foreman installation and configuration
Switch branches/tags
Nothing to show
Pull request Compare This branch is 7 commits ahead, 93 commits behind theforeman:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
apache @ 7f84291
foreman @ 28fb6a6
foreman_proxy @ 126ab8a
passenger @ 0f3eb78
puppet @ e295ab7
tftp @ 9639a1e
xinetd @ 09540eb

Puppet modules for managing Foreman

Installs Foreman as a standalone application or using apache passenger.

Installs Foreman Proxy

May install an example puppet master setup using passenger as well, including the tweaks required for foreman.


Using GIT

git clone --recursive git://

Direct download

Since we are no longer using one repository for all sources, a single tarball is no longer provided. Download the source code for each module on its own:


if you are using RHEL, EPEL repo must be enabled

if you are using Debian (or Ubuntu), see the additional notes in README.debian


Please review the variables under module/manifests/params.pp

Standalone installation:

to install foreman:

echo include foreman | puppet --modulepath /path_to/extracted_tarball

to install both foreman and its proxy:

echo include foreman, foreman_proxy | puppet --modulepath /path_to/extracted_tarball

if you just want to include the relavant bits to run on your puppet master you may

include foreman::params, foreman::config::enc, foreman::config::reports

if you want to install it all on one box

export MODULE_PATH="/etc/puppet/modules/common"
mkdir -p $MODULE_PATH
for mod in apache foreman foreman_proxy passenger puppet tftp xinetd; do
  mkdir -p $MODULE_PATH/$mod
  wget$mod/tarball/master -O - | tar xzvf - -C $MODULE_PATH/$mod --strip-components=1
echo include puppet, puppet::server, foreman, foreman_proxy | puppet --modulepath $MODULE_PATH


  • Fork the project
  • Commit and push until you are happy with your contribution

More info

See or at #theforeman irc channel on freenode

Copyright (c) 2010-2012 Ohad Levy

This program and entire repository 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 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