Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
App::cpanminus(3)     User Contributed Perl Documentation    App::cpanminus(3)

       App::cpanminus -	get, unpack, build and install modules from CPAN

	   cpanm Module

       Run "cpanm -h" or "perldoc cpanm" for more options.

       cpanminus is a script to	get, unpack, build and install modules from
       CPAN and	does nothing else.

       It's dependency free (can bootstrap itself), requires zero
       configuration, and stands alone.	When running, it requires only 10MB of

       There are several ways to install cpanminus to your system.

   Package management system
       There are Debian	packages, RPMs,	FreeBSD	ports, and packages for	other
       operation systems available. If you want	to use the package management
       system, search for cpanminus and	use the	appropriate command to
       install.	This makes it easy to install "cpanm" to your system without
       thinking	about where to install,	and later upgrade.

   Installing to system	perl
       You can also use	the latest cpanminus to	install	cpanminus itself:

	   curl	-L |	perl - --sudo App::cpanminus

       This will install "cpanm" to your bin directory like "/usr/local/bin"
       and you'll need the "--sudo" option to write to the directory, unless
       you configured "INSTALL_BASE" with local::lib.

   Installing to local perl (perlbrew, plenv etc.)
       If you have perl	in your	home directory,	which is the case if you use
       tools like perlbrew or plenv, you don't need the	"--sudo" option, since
       you're most likely to have a write permission to	the perl's library
       path. You can just do:

	   curl	-L |	perl - App::cpanminus

       to install the "cpanm" executable to the	perl's bin path, like

   Downloading the standalone executable
       You can also copy the standalone	executable to whatever location	you'd

	   cd ~/bin
	   curl	-L -o cpanm
	   chmod +x cpanm

       This just works,	but be sure to grab the	new version manually when you
       upgrade because "--self-upgrade"	might not work with this installation

   Troubleshoot: HTTPS warnings
       When you	run "curl" commands above, you may encounter SSL handshake
       errors or certification warnings. This is due to	your HTTP client
       (curl) being old, or SSL	certificates installed on your system needs to
       be updated.

       You're recommended to update the	software or system if you can. If that
       is impossible or	difficult, use the "-k"	option with curl or an
       alternative URL,	""

       perl 5.8.1 or later.

       o   'tar' executable (bsdtar or GNU tar version 1.22 are	recommended)
	   or Archive::Tar to unpack files.

       o   C compiler, if you want to build XS modules.

       o   make

       o   Module::Build (core in 5.10)

   How does cpanm get/parse/update the CPAN index?
       It queries the CPAN Meta	DB site	at <>.
       The site	is updated at least every hour to reflect the latest changes
       from fast syncing mirrors. The script then also falls back to query the
       module at <>	using its search API.

       Upon calling these API hosts, cpanm (1.6004 or later) will send the
       local perl versions to the server in User-Agent string by default. You
       can turn	it off with "--no-report-perl-version" option. Read more about
       the option with cpanm, and read more about the privacy policy about
       this data collection at <>

       Fetched files are unpacked in "~/.cpanm"	and automatically cleaned up
       periodically.  You can configure	the location of	this with the
       "PERL_CPANM_HOME" environment variable.

   Where does this install modules to? Do I need root access?
       It installs to wherever ExtUtils::MakeMaker and Module::Build are
       configured to (via "PERL_MM_OPT"	and "PERL_MB_OPT").

       By default, it installs to the site_perl	directory that belongs to your
       perl. You can see the locations for that	by running "perl -V" and it
       will be likely something	under "/opt/local/perl/..." if you're using
       system perl, or under your home directory if you	have built perl
       yourself	using perlbrew or plenv.

       If you've already configured local::lib on your shell, cpanm respects
       that settings and modules will be installed to your local perl5

       At a boot time, cpanminus checks	whether	you have already configured
       local::lib, or have a permission	to install modules to the site_perl
       directory.  If neither, i.e. you're using system	perl and do not	run
       cpanm as	a root,	it automatically sets up local::lib compatible
       installation path in a "perl5" directory	under your home	directory.

       To avoid	this, run "cpanm" either as a root user, with "--sudo" option,
       or with "--local-lib" option.

   cpanminus can't install the module XYZ. Is it a bug?
       It is more likely a problem with	the distribution itself. cpanminus
       doesn't support or may have issues with distributions such as follows:

       o   Tests that require input from STDIN.

       o   Build.PL or Makefile.PL that	prompts	for input even when
	   "PERL_MM_USE_DEFAULT" is enabled.

       o   Modules that	have invalid numeric values as VERSION (such as

       These failures can be reported back to the author of the	module so that
       they can	fix it accordingly, rather than	to cpanminus.

   Does	cpanm support the feature XYZ of CPAN and CPANPLUS?
       Most likely not.	Here are the things that cpanm doesn't do by itself.

       If you need these features, use CPAN, CPANPLUS or the standalone	tools
       that are	mentioned.

       o   CPAN	testers	reporting. See App::cpanminus::reporter

       o   Building RPM	packages from CPAN modules

       o   Listing the outdated	modules	that needs upgrading. See

       o   Showing the changes of the modules you're about to upgrade. See

       o   Patching CPAN modules with distroprefs.

       See cpanm or "cpanm -h" to see what cpanminus can do :)

       Copyright 2010- Tatsuhiko Miyagawa

       The standalone executable contains the following	modules	embedded.

       CPAN::DistnameInfo Copyright 2003 Graham	Barr
       local::lib Copyright 2007-2009 Matt S Trout
       HTTP::Tiny Copyright 2011 Christian Hansen
       Module::Metadata	Copyright 2001-2006 Ken	Williams. 2010 Matt S Trout
       version Copyright 2004-2010 John	Peacock
       JSON::PP	Copyright 2007-2011 by Makamaka	Hannyaharamitu
       CPAN::Meta, CPAN::Meta::Requirements Copyright (c) 2010 by David	Golden
       and Ricardo Signes
       CPAN::Meta::YAML	Copyright 2010 Adam Kennedy
       File::pushd Copyright 2012 David	Golden

       This software is	licensed under the same	terms as Perl.

       Patches and code	improvements were contributed by:

       Goro Fuji, Kazuhiro Osawa, Tokuhiro Matsuno, Kenichi Ishigaki, Ian
       Wells, Pedro Melo, Masayoshi Sekimura, Matt S Trout (mst), squeeky,
       horus and Ingy dot Net.

       Bug reports, suggestions	and feedbacks were sent	by, or general
       acknowledgement goes to:

       Jesse Vincent, David Golden, Andreas Koenig, Jos	Boumans, Chris
       Williams, Adam Kennedy, Audrey Tang, J. Shirley,	Chris Prather, Jesse
       Luehrs, Marcus Ramberg, Shawn M Moore, chocolateboy, Chirs Nehren,
       Jonathan	Rockway, Leon Brocard, Simon Elliott, Ricardo Signes, AEvar
       Arnfjord	Bjarmason, Eric	Wilhelm, Florian Ragwitz and xaicron.

       <> -	source code repository,	issue
       <irc://> - discussions about cpanm and its related

       This software is	provided "as-is," without any express or implied
       warranty. In no event shall the author be held liable for any damages
       arising from the	use of the software.

       CPAN CPANPLUS pip

perl v5.24.1			  2016-05-24		     App::cpanminus(3)


Want to link to this manual page? Use this URL:

home | help