Skip to content
Perl on Heroku
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


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


You can’t perform that action at this time.