Bitbucket is a code hosting site with unlimited public and private repositories. We're also free for small teams!


Heroku buildpack: Lua

This is a Heroku buildpack for Lua apps.

It comes bundled with Lua 5.1 and LuaRocks

Read a tutorial at


Create an app with the buildpack:

$ heroku create --stack cedar --buildpack

Describing Dependencies

In order to describe the dependencies of you application you must create a rockspec for it.

The first file found that matches *.rockpsec in the root directory will be used. Don't put multiple ones in the root directory otherwise it might get confused.

The buildpack only looks at the dependency information. Meaning you don't have to follow the entire rockspec specification. Minimally, your rockspec could look something like this:

-- my_app.rockspec
dependencies = {
    "xavante >= 2.2.1",

As shown above, if you want to include rockspec or rock files by url you can place them in the dependencies table. (This is not supported by LuaRocks, only by this buildpack).

This file must exist, even if you have no dependencies. The rockspec is parsed in prepare.moon.

Using Dependencies

The buildpack installs the dependencies to packages/ and Lua to bin/lua.

Before you can require any of your dependencies, you must update your package.path by requiring packages.init.

-- web.lua
require "packages.init"
require "xavante"

xavante.HTTP {

If you're running testing locally as well, and packages.init doesn't exist, do something like this:

pcall(require, "packages.init")

Running a Process

To spawn your server create a Procfile similar to:

web:     bin/lua web.lua $PORT

Where web.lua is the entry point to your Lua application.

Recent activity

Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.