Out of the box it features group collaboration, campaign and lead management, contact lists, and opportunity tracking.

Contacts

Opportunities

Accounts

Tasks

Active development started in November 2008. New features, enhancements, and updates appear on regular basis.

Pull requests and bug reports are always welcome!

• Ruby v1.9.3
  • Note that Ruby v1.8.7 was supported until v0.11.4 (see https://github.com/fatfreecrm/fat_free_crm/tree/ruby1.8)
• MySQL v4.1.1 or later (v5+ is recommended), SQLite v3.4 or later, or Postgres 8.4.8 or later.
• ImageMagick (optional, only needed if you would like to use avatars)

(Ruby on Rails and other gem dependencies will be installed automatically by Bundler.)

• Git source code repository: git clone git://github.com/fatfreecrm/fat_free_crm.git
• .zip or .tgz archives: http://github.com/fatfreecrm/fat_free_crm/downloads

Please view one of the following installation guides:

Installing Fat Free CRM on Linux or Mac OS X

Setting up a Heroku instance for Fat Free CRM

Installing Fat Free CRM on Microsoft Windows

Run this bash script to quickly setup a Ubuntu server

Run the Fat Free CRM gem within a separate Rails application. This is the best way to deploy Fat Free CRM if you need to add plugins or make any customizations.

If you are upgrading from version 0.11.3 (Dec 21st 2012) or below, please see an important fix for country data

If you are upgrading from version 0.10.1 or below to the latest Rails 3.x version, your database schema needs to be updated.

Please run the following commands in this order:

bundle install --without heroku   # Installs gem dependencies
rake ffcrm:upgrade:schema         # Updates your schema to use the new timestamped migrations
rake db:migrate                   # Runs any new database migrations.

Fat Free CRM can be customized by implementing callback hooks and extended by creating Rails Engines plugins. Check out these sample repositories demonstrating the concepts:

• http://github.com/michaeldv/crm_sample_plugin/tree/master
• http://github.com/michaeldv/crm_sample_tabs/tree/master
• http://github.com/michaeldv/crm_web_to_lead/tree/master
• http://github.com/michaeldv/crm_tags/tree/master

• Michael Dvorkin (@michaeldv) - Founding creator
• Nathan Broadbent (@ndbroadbent)
• Ben Tillman (@warp)
• Steve Kenworthy (@steveyken)

See the contributors graph and the contributors file for further details.

Copyright (c) 2008-2013 by Michael Dvorkin. All rights reserved.

This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

See LICENSE file for more details.