whatisgithub

What is fat_free_crm?

fatfreecrm/fat_free_crm — explained in plain English

Analysis updated 2026-05-18

3,626RubyAudience · developerComplexity · 3/5LicenseSetup · moderate

In one sentence

Fat Free CRM is a self-hosted, open-source Ruby on Rails customer relationship management platform for tracking contacts, deals, and campaigns.

Mindmap

mindmap
  root((fat-free-crm))
    What it does
      Contact management
      Deal pipeline
      Campaign tracking
      Task assignment
    Tech stack
      Ruby on Rails
      MySQL
      PostgreSQL
      SQLite
    Use cases
      Small team CRM
      Self-hosted sales tool
      Embeddable Rails module
    Extensibility
      Webhook plugins
      Record merging
      Time tracking

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Self-host a CRM for a small sales team to track contacts, accounts, and deals through a pipeline.

USE CASE 2

Run marketing campaigns and assign follow-up tasks without paying for a commercial CRM subscription.

USE CASE 3

Embed the CRM as a module inside a larger Ruby on Rails application for deeper customization.

What is it built with?

RubyRuby on RailsMySQLPostgreSQLSQLite

How does it compare?

fatfreecrm/fat_free_crmnesquena/rablscenic-views/scenic
Stars3,6263,6313,621
LanguageRubyRubyRuby
Setup difficultymoderateeasymoderate
Complexity3/53/52/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 1h+

Requires Ruby 3.1 or later plus a supported database such as PostgreSQL or MySQL.

MIT license, use freely for any purpose including commercial use, keep the copyright notice.

So what is it?

Fat Free CRM is an open-source customer relationship management platform, the kind of software businesses use to track their interactions with leads and customers. It is built with Ruby on Rails, a popular web framework, and you self-host it on your own server rather than paying for a subscription to a commercial CRM service like Salesforce or HubSpot. Out of the box it handles the things a small sales or marketing team would need: managing contacts, tracking business accounts, following potential deals through a pipeline, running campaigns, and assigning tasks. Teams can work together in groups, and records can be tagged and organized with custom fields if the default data structure does not match how your organization thinks about customers. The README includes dashboard screenshots showing contact creation, opportunity management, account editing, and task creation as core parts of the interface. The platform can be extended with plugins that add features like webhook notifications, record merging, and time tracking. Developers can also embed it as a module inside a separate Rails application if they want to customize it more deeply or combine it with other software. Installation requires Ruby 3.1 or later and a database, with MySQL, PostgreSQL, and SQLite all supported. Guides are available for setting it up on Linux, Mac, and through Heroku. The project is released under the MIT license, meaning anyone can use, modify, or redistribute it without cost. It has been maintained since 2008 by an open-source contributor community, which also runs a Discord server for people who want to ask questions or get involved.

Copy-paste prompts

Prompt 1
Walk me through installing Fat Free CRM locally with PostgreSQL on Linux.
Prompt 2
Explain how to add custom fields and tags to contacts in Fat Free CRM.
Prompt 3
Show me how to embed Fat Free CRM as a module inside an existing Rails app.
Prompt 4
What plugins are available for Fat Free CRM and how do I add webhook notifications?

Frequently asked questions

What is fat_free_crm?

Fat Free CRM is a self-hosted, open-source Ruby on Rails customer relationship management platform for tracking contacts, deals, and campaigns.

What language is fat_free_crm written in?

Mainly Ruby. The stack also includes Ruby, Ruby on Rails, MySQL.

What license does fat_free_crm use?

MIT license, use freely for any purpose including commercial use, keep the copyright notice.

How hard is fat_free_crm to set up?

Setup difficulty is rated moderate, with roughly 1h+ to a first successful run.

Who is fat_free_crm for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.