Setup Heroku

Note: This README has been updated for the Heroku cedar stack.

Using Heroku, you can deploy a Fat Free CRM instance within minutes.

Pre-requisites

• A heroku account – sign up at https://www.heroku.com/
• The heroku toolkit – see https://toolbelt.heroku.com/ for installation guide

Set up a Fat Free CRM Instance on Heroku

git clone https://github.com/fatfreecrm/fat_free_crm.git /path/to/ffcrm
cd /path/to/ffcrm
heroku login

Optional: when you deploy to Heroku, it injects some plugins to help with asset generation and logging. You will receive lots of DEPRECATION WARNING: You have Rails 2.3-style plugins in vendor/plugins messages. To fix this, add 'rails_12factor', group: :production to your Gemfile and run bundle install. Don’t forget to commit the change before pushing to heroku. (See this article for more details)

Push code to heroku:

heroku create
heroku config:add HEROKU=true
git push heroku master
heroku run rake db:migrate
heroku run rake ffcrm:demo:load # if you want demo data
heroku run rake ffcrm:setup:admin USERNAME=admin PASSWORD=admin [email protected]
heroku ps:scale web=1
heroku open

Other useful heroku commands

heroku restart  # restart the webservers
heroku ps  # is the webserver running?
heroku logs --ps web.1 --tail  # tail the log of a specific webserver process (web.1)
git push heroku your-branch-name:master  # to push a different branch to the webserver

Further reading

See https://devcenter.heroku.com/articles/getting-started-with-rails3