Installing on Heroku

Heroku is a great service that allows you to deploy your Rails apps, like Teambox, in just a few simple steps.

Get a Heroku account

You need to sign up for Heroku first. Then, install the “heroku” gem:

$ gem install heroku

Get Teambox code

To push an app to Heroku, you first need to have it locally. Teambox is versioned with git and available on GitHub.

$ git clone git://github.com/micho/teambox.git
$ cd teambox

Create a Heroku app

Teambox is now using Bundler, so it’s easier to setup Heroku with “bamboo-stack”

$ heroku create --stack bamboo-ree-1.8.7

Your new instance will get a random name.

Enable add-ons (optional)

Note: Heroku might ask you to verify your account before using add-ons.

Teambox uses memcache and sends outgoing email. Enabling that is easy:

$ heroku addons:add sendgrid:free
$ heroku addons:add memcache:5mb

Configure Amazon S3 for uploads

If you want to upload files to Teambox on Heroku, you need an Amazon S3 account. You also need to configure the environment with your credentials. Find your Amazon security credentials here.

$ heroku config:add S3_KEY=123 S3_SECRET=xzy S3_BUCKET=mybucket

Replace “mybucket” with a unique name of the bucket you wish to use.

Push the Teambox code

The final step is pushing Teambox code to your new Heroku instance.

$ git push heroku master
$ heroku rake db:schema:load

At this point, your app should be up and running! Open it in a browser:

$ heroku open

When you wish to rename it (it still has the random name) just run:

$ heroku rename fancy-new-name