RapidApp::Manual::Installation - Installing RapidApp on a new system

Install with Docker

A complete installation of the current version RapidApp is available on Docker Hub in the rapi/psgi. If you have docker on your system, this is the fastest way to install RapidApp and its dependencies:

  docker pull rapi/psgi

For more information, see the rapi/psgi documentation on Docker Hub:

Install from CPAN

RapidApp is a standard CPAN package and can be installed in the standard manner:

  cpanm RapidApp

RapidApp does have a lot of dependencies so be prepared for this to take a while.

If you are new to perl and you don't have cpanm (or know what it is) is, or if you would like to play with RapidApp without messing with your main system perl, see the next section for installation with perlbrew.

Installation via Perlbrew

The following is the typical series of commands to run to install a fresh version of perl into your home directory using perlbrew. This isn't specific to RapidApp, but perl in general. See for more info on the perlbrew project.

Run the following commands on any Unix system (including Linux and Mac) to install a fresh perlbrew and RapidApp:

  wget -O - | bash

Assuming the above worked, it should tell you to run this:

  source ~/perl5/perlbrew/etc/bashrc

Now you have the perlbrew command and you can install a version of perl. To see the available versions, you can run perlbrew available. Choose one from the list and install it. For example:

  perlbrew install perl-5.20.1

The above command may take a while. Once it completes, make it the active perl and install cpanm

  perlbrew switch perl-5.20.1
  perlbrew install-cpanm

Now both perl and cpanm should point to the new perlbrew version within your shell (as long as you source their bashrc file). To remember this for your account for next time, do something like the following:

  echo -e "\nsource ~/perl5/perlbrew/etc/bashrc" >> ~/.bash_profile

Now you can install RapidApp:

  cpanm RapidApp

Alternative one-line install

The above list of steps can be performed all at once using the instant-perlbrew script which is available on GitHub. If you are feeling brave, you can paste this one-liner to install perlbrew+RapidApp on most Unix-based systems in one swoop:

  time wget -O - \ \
   | bash -s perl-5.20.1 RapidApp

This can take in the neighborhood of an hour, depending on the speed of your system. See for more information on the script and exactly what it does.