Fat Free CRM is next generation open source CRM platform. Active development has started in November 2008; new features, enhancements, and updates appear on daily basis.
Here are the steps to get Fat Free CRM up and running on your system.
-
Ruby v1.8.7 or v1.9.2
-
MySQL v4.1.1 or later (v5+ is recommended), SQLite v3.4 or later, or Postgres 8.4.8 or later.
-
ImageMagick (optional, only if you would like to use avatars)
(Ruby on Rails v3 and other gem dependencies will be installed automatically by Bundler.)
-
Git source code repository: git://github.com/michaeldv/fat_free_crm.git
-
.zip or .tgz archives: github.com/michaeldv/fat_free_crm/downloads
If you are upgrading from version 0.10.1 or below, your database schema needs to be updated. After you have installed the latest Rails 3 version, please run the following commands in this order:
$ bundle install # Installs gem dependencies $ rake crm:upgrade:schema # Updates your old schema to use the new timestamped migrations $ rake db:migrate # Runs the new database migrations.
Fat Free CRM supports MySQL and SQLite databases. The source code comes with two sample database configuration files: config
/database
.mysql
.yml
for MySQL and config
/database
.sqlite
.yml
for SQLite. Based on your choice of the database create the actual database configuration file, for example:
$ cp config/database.mysql.yml config/database.yml
Edit config/database.yml and specify database names and authentication details.
Fat Free CRM includes a ‘smart’ Gemfile that detects your chosen database, and installs the required gems. After you have configured your database.yml file, run the following command from the applications root directory:
$ bundle install
Now you are ready to create the database:
$ rake db:create
The next step is to load default Fat Free CRM settings, such as menu structures, default colors, etc. and create the Admin user. This is done by running the following rake task:
$ rake crm:setup
You can test drive Fat Free CRM by loading sample records that are generated on the fly mimic the actual use. IMPORTANT: loading demo will delete all the existing data.
$ rake crm:demo:load
Among other things the demo generator creates 8 sample user records with the following usernames: aaron
, ben
, cindy
, dan
, elizabeth
, frank
, george
, and heather
. You can log in with any of these names using the name as password. The demo site at demo.fatfreecrm.com provides access as a sample user as well.
You can reset the database and reload demo data at any time by using:
$ rake crm:demo:reload
Now you should be able to launch the Rails server and point your web browser to localhost:3000
$ ruby script/server
When deploying with Phusion Passenger, also install Rack 1.0.1:
$ gem install rack -v 1.0.1
-
Home page: www.fatfreecrm.com
-
Online demo: demo.fatfreecrm.com
-
Project page: github.com/michaeldv/fat_free_crm/tree/master
-
Features and bugs: fatfreecrm.lighthouseapp.com
-
Twitter commit updates: twitter.com/fatfreecrm
-
Discussion group for users: groups.google.com/group/fat-free-crm-users
-
Discussion group for developers: groups.google.com/group/fat-free-crm-dev
-
IRC channel: #fatfreecrm on irc.freenode.net
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
Copyright © 2008-2011 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.