Run sbcl-powered lisp-based web apps on Red Hat's OpenShift
Common Lisp Emacs Lisp Scheme C Shell XML Other
Switch branches/tags
Nothing to show
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


This package provides everything you need to start hosting Common Lisp-based web applications on OpenShift, Red Hat's free, auto-scaling Platform as a Service (PaaS) cloud solution.

The default app template uses SBCL and a quicklisp-based dev platform with the hunchentoot web server.

lisp-openshift will auto-provision a lisp environment into your DIY OpenShift project. It does this by downloading and extracting the contents of the SBCL RPM package from the Fedora Project's Extra Packages for Enterprise Linux (EPEL) repository. This package is installed in your application's persistent data directory.

Running on OpenShift

Create an account at

Install your commant line tools as instructed at

Create a DIY application

rhc app create -a myapp -t diy-0.1

Add this upstream lisp-openshift repo

cd myapp
git remote add upstream -m master git://
git pull -s recursive -X theirs upstream master

Then push the repo upstream

git push

That's it! You can now have a look at your application here:


To see it in action, check out

Using Quicklisp

Quicklisp is a library manager for Common Lisp. This project contains a Quicklisp repository of core packages for simple web applications, however, the upstream Quicklisp project hosts over 700 libraries.

To install more libraries into your project's repository, simply cd into the top level of your project (this directory), start sbcl with your HOME set to the current directory, and use ql:quickload as usual.

$ HOME=`pwd` sbcl
This is SBCL 1.0.51-1.fc16, an implementation of ANSI Common Lisp.
More information about SBCL is available at <>.

SBCL is free software, provided as is, with absolutely no warranty.
It is mostly in the public domain; some portions are provided under
BSD-style licenses.  See the CREDITS and COPYING files in the
distribution for more information.
* (ql:quickload :cl-mongo)

This would add the cl-mongo package to your application.


Happy hacking!

Anthony Green