This document will explain how to install The Lounge on Heroku. If you want to learn about Heroku you should read their documentation.

Step 1:

Begin by logging in with the Heroku toolbelt:

heroku login

Step 2:

Clone the repository and install The Lounge from source:

git clone https://github.com/thelounge/lounge
cd lounge
npm install
NODE_ENV=production npm run build

Step 3:

In the lounge/ directory, run:

heroku create

Step 4: (optional)

This step is only useful if you want to run The Lounge with users accounts.

Create a Procfile and edit the content to look like this:

web: node index --private --home /app

You can read more about Procfiles here.

To create users, run the following in the lounge/ directory:

./index.js --home . add <username>

Step 5:

Time to publish to Heroku!

If you’ve made any changes to the repository (like adding users or the Profile), don’t forget to save the changes with git:

git add .
git commit -m "Added Heroku files"

And with that done, lets go ahead and push to Heroku:

git push heroku