Pointers on Heroku Setup

This is more of a to-do list, rather than a guide. This is what I did, and I know there are easier and faster ways out there in the internet. So go Google for it!

First things first!

• You should have Git and a GitHub account by now, with SSH Keys 
• Fork fat_free_crm.
• Create a Heroku account.

Then, Heroku prerequisites...

1. Install Ruby (on Rails)
2. Install RubyGems (using Ruby)
3. Install the Heroku gem. (using RubyGems) 
4. Read the Heroku quickstart guide

Eventually, you'll end up at...

• Downloading the fat_free_crm from GitHub (or git clone <fat_free_crm's git link>)
• Following the fat_free_crm README file
• heroku create <name of your app> or simply heroku create
• git push heroku master

In case of an error...

If you did everything to the letter (set up Heroku, did a heroku create and git push heroku master), there's a high chance of your deployment to fail.

In fact, if you go to your website on Heroku, you may get this:

What I assume is that fat_free_crm is in constant development, so it may have broken Heroku integration in the process in one way or another.

Fortunately, an alternative is to try out Ryan Wood's version / fork of fat_free_crm. http://ryanwood.com/past/2010/1/21/fat-free-crm-on-heroku/

This particular fork is already configured and set-up for Heroku deployment. All you have to do is heroku create, then git push heroku master.

If you did it right, you should get the Fat Free CRM login page