node package manager
Stop wasting time. Easily manage code sharing in your team. Create a free org »



Lamassu admin server. First part of Lamassu stack you need to install.


git clone
cd lamassu-admin
npm install

You also need a Postgres running. Postgres is required for storing configuration of the remote server. Install Postgres with your package manager of choice, then:

sudo su - postgres
createuser --superuser lamassu
createdb -U lamassu lamassu

Then you need SQL scripts to seed initial configs. They are under /database. You can bootstrap your database by running:

psql lamassu lamassu < database/lamassu.sql


You'll be able to configure your stack when you start the server for the first time.


node app.js

Then, open it.



Both lamassu-admin and lamassu-server are deployable to Heroku.

First, you need to get a Heroku account and install the Heroku toolkit.

The easy way is an easy installation and deployment script. You can run it standalone, without cloning lamassu-admin. It'll clone both repositories to your current working directory and deploy them to Heroku:

mkdir lamassu
curl >
chmod +x

You can deploy updates to your applications by rerunning

A bit harder way

You can also clone and deploy each app individually. To do that, clone both lamassu-admin and lamassu-server.

git clone
git clone

Next, deploy lamassu-admin:

cd lamassu-admin

Visit the deployed application to configure your Lamassu ATM. Make sure to input all required API keys.

Next, to deploy lamassu-server you need to grab DATABASE_URL for the Postgres database our deployment script created.

db=$(heroku config:get DATABASE_URL)

Then, go to lamassu-server and deploy it:


You need to pass DATABASE_URL to it since both lamassu-admin and lamassu-server use the same database.

Both applications should be deployed and running.