EspoCRM open source CRM application
JavaScript PHP Smarty CSS Other
Latest commit ac2e244 Jan 20, 2017 @yurikuzn yurikuzn fix notification update


EspoCRM is an Open Source CRM (Customer Relationship Management) software that allows you to see, enter and evaluate all your company relationships regardless of the type. People, companies or opportunities - all in an easy and intuitive interface.

It's a web application with a frontend designed as a single page application based on backbone.js and a REST API backend written in PHP.

Download the latest release from our website.


  • PHP 5.5 or above (with pdo, json, gd, mcrypt extensions);
  • MySQL 5.1 or above.

For more information about server configuration see this article.

How to report bug

Create an issue here or post on our forum.

How to get started (for developers)

  1. Clone repository to your local computer.
  2. Change to the project's root directory.
  3. Install composer.
  4. Run composer install if composer is installed globally or php composer.phar install if locally.

Never update composer dependencies if you are going to contribute code back.

Now you can build. Build will create compiled css files.

To compose a proper config.php and populate database you can run install by opening http(s)://{YOUR_CRM_URL}/install location in a browser. Then open data/config.php file and add isDeveloperMode => true.

How to build

You need to have nodejs and Grunt CLI installed.

  1. Change to the project's root directory.
  2. Install project dependencies with npm install.
  3. Run Grunt with grunt.

The build will be created in the build directory.

How to contribute

Before we can merge your pull request you need to accept our CLA here. It's very simple to do.

How to make a translation

Build po file with command: node po.js en_EN (specify needed language instead of en_EN)

After that translate the generated po file.

Build json files from the translated po file:

  1. Put your po file espocrm-en_EN.po into build directory
  2. Run node lang.js en_EN

Json files will be created in build directory grouped by folders.


EspoCRM is published under the GNU GPLv3 license.