Perl on Heroku
Latest commit f5a55a8 Aug 21, 2014 @judofyr Add license
Failed to load latest commit information.
bin Allow for cpanfile as well as Makefile.PL. Jan 4, 2014
support Add license Aug 21, 2014


Deploy Perl applications in seconds.

Step 1

Write an app:

#!/usr/bin/env perl
use Mojolicious::Lite;

get '/' => sub {
  my $self = shift;


@@ index.html.ep
% layout 'default';
% title 'Welcome';
Welcome to the Mojolicious real-time web framework!

@@ layouts/default.html.ep
<!DOCTYPE html>
  <head><title><%= title %></title></head>
  <body><%= content %></body>

Step 2

Create a Makefile.PL with your dependencies:

use strict;
use warnings;

use ExtUtils::MakeMaker;

  NAME         => '',
  VERSION      => '1.0',
  AUTHOR       => 'Magnus Holm <>',
  EXE_FILES    => [''],
  PREREQ_PM    => {'Mojolicious' => '2.0'},
  test         => {TESTS => 't/*.t'}

Alternately, you may create a cpanfile that lists dependencies instead:

requires 'Mojolicious', '2.0';

Step 3

Create an executable file called Perloku which runs a server on the port given as an enviroment variable:

./ daemon --listen http://*:$PORT

Test that you can start the server:

chmod +x Perloku
PORT=3000 ./Perloku

Step 4


git init
git add .
git update-index --chmod=+x Perloku (only if using Windows)
git update-index --chmod=+x (only if using Windows)
git commit -m "Initial version"
heroku create -s cedar --buildpack
git push heroku master


Counting objects: 5, done.
Delta compression using up to 8 threads.
Compressing objects: 100% (4/4), done.
Writing objects: 100% (5/5), 808 bytes, done.
Total 5 (delta 0), reused 0 (delta 0)

-----> Heroku receiving push
-----> Fetching custom buildpack... done
-----> Perloku app detected
-----> Vendoring Perl
       Using Perl 5.16.2
-----> Installing dependencies
       --> Working on /tmp/build_19tm6pb8ch1qa
       Configuring /tmp/build_19tm6pb8ch1qa ... OK
       ==> Found dependencies: Mojolicious
       --> Working on Mojolicious
       Fetching ... OK
       Configuring Mojolicious-2.48 ... OK
       Building Mojolicious-2.48 ... OK
       Successfully installed Mojolicious-2.48
       <== Installed dependencies for /tmp/build_19tm6pb8ch1qa. Finishing.
       1 distribution installed
       Dependencies installed
-----> Discovering process types
       Procfile declares types   -> (none)
       Default types for Perloku -> web
-----> Compiled slug size is 12.4MB
-----> done, v5 deployed to Heroku

 * [new branch]      master -> master