README

EspoCRM



EspoCRM is a free, open-source CRM platform designed to help organizations build and maintain strong customer relationships.
It provides a wide range of tools to store, organize, and manage leads, contacts, sales opportunities, marketing campaigns,
support cases, and more – all business information in a simple and intuitive interface.

!Screenshot


 Architecture

EspoCRM is a web application with a frontend designed as a single-page application and a REST API
backend written in PHP.

 Demo

You can try the CRM on an online demo.

 Requirements

 PHP 8.3 - 8.5;
 MySQL 8.0 (and later), or MariaDB 10.6 (and later);
 PostgreSQL 15 (and later).

For more information about server configuration, see this article.

 Download

Download the latest release from our website or from GitHub releases.

 Release notes

Release notes are available at GitHub releases.

 Documentation

See the documentation for administrators, users and developers.

 Why EspoCRM?

 Open-source transparency. EspoCRM's source code is open and accessible, so anyone can inspect it and see how data is being managed within the CRM.
 Customization freedom. You can develop features, create custom entities, fields, relationships, buttons to make the system fit your specific needs. EspoCRM is more than a CRM – it's a platform for building custom business applications.
 Clean user interface. EspoCRM offers an uncluttered, minimalist, and fast user interface, which is easy to navigate and has a short learning curve.
 Straightforward REST API. It can be easily integrated with other applications using a REST API.

 Who is EspoCRM for?

 From startups, small & medium-sized businesses to larger organizations. A flexible, fully customizable solution that scales with your needs.
 Developers & tech enthusiasts. You can extend functionalities, build extensions, and create custom integrations.
 Anyone seeking a free or on-premise CRM.

 Installing stable version

See installation instructions:

 Manual installation
 Installation by script
 Installation with Docker
 Installation with Traefik

 Bug reporting

Create a GitHub issue or post on our forum.

 Development

See the developer documentation.

We highly recommend using an IDE for development. The backend codebase adheres to SOLID principles, utilizes interfaces, static typing and generics. We recommend to start learning EspoCRM from the Dependency Injection article in the documentation.

Metadata plays an integral role in the EspoCRM application. All possible parameters are described with a JSON Schema, meaning you will have autocompletion in the IDE. You can also find the full metadata reference in the documentation.

The frontend is an SPA built on a custom framework. It utilizes nested views and service DI, with the core partially written in TypeScript. Developers primarily work with existing form and field view implementations.

 Community & Support

If you have a question regarding some features, need help or customizations, want 

Top issues

Latest release

Fixes: 

 - Kanban: Error message when changing status field value to a kanban-hidden status https://github.com/espocrm/espocrm/issues/3821