h1. How to Install a Smart-Proxy Plugin

Smart-Proxy plugins are ruby gems. Below are recommended methods for installation.

h2. RPM Installations

Some plugins are available from Foreman repositories packaged as rpms. The repos are available at [[yum.theforeman.org/plugins]]. Separate repos are available for each Foreman release, containing plugins that are compatible with that particular version. Packages are not currently GPG signed.

Configure the repo by creating /etc/yum.repos.d/foreman_plugins.repo:

<pre>

[foreman-plugins]

name=Foreman plugins

baseurl=http://yum.theforeman.org/plugins/nightly/el6/x86_64/

enabled=1

gpgcheck=0

</pre>

Find the package for the plugin:

<pre>yum search rubygem-smart-proxy</pre>

Install the package, e.g.

<pre>yum install rubygem-smart_proxy_pulp</pre>

Restart Smart-Proxy with <pre>service foreman-proxy restart</pre>

Some plugins may require configuration in /etc/foreman-proxy/settings.d/, check for any .example files.