Forge Home


Provides a puppet type to easily install Perl CPAN modules.


474,391 latest version

4.6 quality score

We run a couple of automated
scans to help you access a
module's quality. Each module is
given a score based on how well
the author has formatted their
code and documentation and
modules are also checked for
malware using VirusTotal.

Please note, the information below
is for guidance only and neither of
these methods should be considered
an endorsement by Puppet.

Version information

  • 2.0.0 (latest)
  • 1.0.1
  • 1.0.0
  • 0.0.1
released Aug 12th 2016
This version is compatible with:
  • ,

Start using this module

  • r10k or Code Manager
  • Bolt
  • Manual installation
  • Direct download

Add this module to your Puppetfile:

mod 'meltwater-cpan', '2.0.0'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add meltwater-cpan
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install meltwater-cpan --version 2.0.0

Direct download is not typically how you would use a Puppet module to manage your infrastructure, but you may want to download the module in order to inspect the code.



meltwater/cpan — version 2.0.0 Aug 12th 2016


Puppet Forge Version Puppet Forge Downloads Travis branch By Meltwater Maintenance license

Table of Contents

  1. Overview
  2. Module Description - What the module does and why it is useful
  3. Setup - The basics of getting started with cpan
  4. Usage - Configuration options and additional functionality
  5. Reference - An under-the-hood peek at what the module is doing and how


Handle installations of cpan modules via puppet.

Module Description

The cpan module sets up capn on a server


What puppet-cpan affects

  • cpan package.
  • cpan configuration file.


All options and configuration can be done through interacting with the parameters on the cpan class and the cpan resource type. These are documented below.

cpan class

class {'::cpan':
  manage_config  => true,
  manage_package => true,
  package_ensure => 'present',
  installdirs    => 'site',
  local_lib      => false,
  config_hash    => { 'build_requires_install_policy' => 'no' },

Beginning with cpan

include '::cpan'
cpan { "Clone::Closure":
  ensure  => present,
  require => Class['::cpan'],
  force   => true,

Package Management

To avoid conflicts with in house package management, use:

class {'::cpan':
  manage_package => false,

Install Destination

To control target installation path, use:

class {'::cpan':
  installdirs => 'vendor',

Any of site (default), perl and vendor are accepted.

To further control the location of installed modules, you can use local::lib:

cpan { 'Foo::Bar':
  ensure    => present,
  local_lib => '/opt',

This will install the module into /opt. Of course you need to adjust @INC of your code in order to use that new location, e.g. by using perl -Mlocal::lib=/opt

You can also define the default value of local_lib for all cpan resources:

Cpan { local_lib => '/opt' }



  • cpan: Main class for installation and service management.
  • cpan::install: Handles package installation.
  • cpan::params: Different configuration data for different systems.
  • cpan::config: Handles the cpan service.










This module has been built on and tested against Puppet 3.x and Puppet 4.x

The module has been tested on:

  • RedHat Enterprise Linux 6/7
  • Debian 6/7
  • CentOS 6/7

Testing on other platforms has been light and cannot be guaranteed.