Common Lisp on Heroku -- Example Project

This project is an example of how to use my fork of the Heroku Common Lisp Buildpack. See the buildpack repository for more information and credits.

This is the Hunchentoot branch.

Example App: http://young-ocean-1914.herokuapp.com/

Instructions:

First, get yourself set up with a Heroku account and tools.

Then fork this project (and optionally modify it with your own content).

Change directory into the heroku-cl-example.

Next, create your own Heroku application using CL Buildpack:

heroku create -s cedar --buildpack http://github.com/jsmpereira/heroku-buildpack-cl.git

Install http://devcenter.heroku.com/articles/labs-user-env-compile to have config vars available at build time.

You can choose implementation via: heroku config:add CL_IMPL=sbcl or heroku config:add CL_IMPL=ccl

Choose webserver via: heroku config:add CL_WEBSERVER=hunchentoot or heroku config:add CL_WEBSERVER=aserve

To avoid trouble with SBCL source encoding use: heroku config:add LANG=en_US.UTF-8

And deploy:

git push heroku branch

Where you should replace branch with the branch of your choice. There are currently 2 branches. Master has Huchentoot specific code and aserve has AllegroServe specific code.

That's it! Use heroku open to view your app in your browser!

More details:

Currently https://github.com/jsmpereira/heroku-buildpack-cl let's you run Hunchentoot with SBCL and CCL and AllegroServe(portableaserve) with CCL.

There is a pending issue with acl-compat bundled with portableaserve preventing use with SBCL. Look here for more information.

The file heroku-setup.lisp gets loaded at compile time, and needs to load any Lisp files or packages required.

Thanks to Mike Travers for getting Common Lisp on Heroku.