Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Puppet Ruby
Branch: master

style nits

latest commit ec7c004c21
@mmoll mmoll authored committed

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.

download the source code from


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
wget -O - |tar xzvf - -C $MODULE_PATH --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

Copyright (c) 2010-2011 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

Something went wrong with that request. Please try again.