Skip to content
Basic Pulp support for Foreman Smart-Proxy
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
settings.d Cleanup pulp3 settings Feb 28, 2019
test Use custom validator for pulp url Mar 12, 2019

Foreman Pulp Plugin

Foreman project plugin for Pulp allowing Katello hosts to interact with Pulp application services for content management While this plugin is part of the Foreman project it can only be used with Katello as Foreman is not content aware without the Katello plugin.

Getting Started

The Foreman project provides documentation on this specific plugin installation from multiple methods, distribution specific RPM, distribution specific DEB and direct manual build from source. The plugin can also be installed as part of the foreman-installer puppet class with the "--[no-]enable-foreman-proxy-plugin-pulp" option. Documentation can be found here for how to install a stand alone smart proxy


  • working Katello instance (note not Foreman - must be Katello)
  • smart proxy or capsule with the Pulp plugin installed and enabled
  • Pulp installation as part of the Katello install, or a remote Pulp service to connect to


Assuming prerequisites are met, the Pulp plugin must be enabled in the Foreman-proxy directory with the pulp.yaml and pulpnode.yaml the following parameters are required to be set

# Pulp integration
:enabled: true
# Path to Pulp, Pulp content and mongodb directories
:pulp_dir: directory for Pulp on the Pulp node
:pulp_content_dir: where the Pulp content is held
:puppet_content_dir: where the puppet modules are held
:mongodb_dir: the mongodb datadir for Pulp

for example

# Pulp integration
:enabled: true
:pulp_url: # (note Katello installs are normally
# Path to Pulp, Pulp content and mongodb directories
:pulp_dir: /var/lib/pulp
:pulp_content_dir: /var/lib/pulp/content
:puppet_content_dir: /etc/puppetlabs/code/environments
:mongodb_dir: /var/lib/mongodb

Running the tests

Todo - some test examples



This project is licensed under the GNU General Public License v3.0 - see the file for details


  • Foreman IRC user areyus who prompted the need for this README
You can’t perform that action at this time.