Self-Hosted CRM
Self-hosted CRM: client records and next steps on your own servers
Run the Customermates application and PostgreSQL on infrastructure you control, with MCP for your own AI client. The inbox for LinkedIn and email conversations and Mate's reply drafts need Customermates Cloud.
AGPL core • Docker Compose • PostgreSQL 16
How it works
Everything your follow-up needs, in one place. Four parts that work together.
Your knowledge, your client data and your conversations live together, so every agent that helps you works from the same facts.
Agents
Every plan, Mate on paid CloudMate is built in. Or connect the AI you already pay for, and it works with the same records and rules.
Inbox
Cloud, from ProEmail and LinkedIn, plus WhatsApp, Instagram and Telegram, beside the client each conversation belongs to.
Data
Every planClients, deals and any list your business needs, with your own fields, stages and views.
Knowledge
Every planPlaybooks, prices and how you work, written once. Mate and connected agents use the pages their permissions allow.
Start from one description
One description. A workspace your agent built.
This is what setup builds from one sentence. Sample data, the real product.
Describe your business
One sentence about your team, your clients and how you sell.
Mate builds it
It asks a few questions, then creates the lists, pipeline, dashboard and playbook.
Work in it
Connect LinkedIn and email. Click through a finished example below.
We're a four-person strategy consultancy. Track clients, engagements and proposals, and help us follow up with prospects on LinkedIn.
Widgets built from the workspace's own lists and fields
Ways you can use it
Pick the job. The workspace follows.
- Follow up on LinkedIn conversationsLinkedIn and email threads sit on the client. Mate drafts the reply and dates the next step, and you review and send it in the conversation.See LinkedIn in the inbox
- Follow up on every proposal after the callClients, engagements and proposals with the conversations behind them, and a dated next step on each.CRM for consultants
- Keep client next steps on one dashboardEvery client gets a dated next step, and your dashboard shows what is due across all of them.See follow-up
- Let your own Claude or ChatGPT work in your CRMConnect Claude, ChatGPT, Cursor or another MCP client. It reads and updates your workspace within your permissions.Connect your agent
How it works
How to evaluate the deployment
- 01
Inspect the exact deployment
Read the self-hosting guide and review the current Compose file in the repository.
- 02
Check the edition boundary
Confirm that the Starter feature set covers the records, views and interfaces your workflow needs.
- 03
Map external services
List every email (Resend), OAuth, monitoring, workflow or AI provider you plan to configure and the data each one receives.
- 04
Design operations
Define backups, tested restoration, upgrades, TLS, monitoring and access control for your environment.
- 05
Test without customer data
Run the complete workflow in a non-production environment before the system handles real records.
In the product
At a glance
Runs on your infrastructure
The Customermates application and PostgreSQL 16 run as two services in the tracked Docker Compose deployment.
Included product surface
Core CRM records, custom fields and views, REST, webhooks and MCP with the Starter feature set.
You operate
Network access, TLS, updates, backups, restore tests, monitoring and every configured external provider.
Cloud-only boundary
Connected messaging, the unified inbox, connected calendar, hosted Mate and hosted AI credits stay outside self-hosting.
Customermates is a self-hosted CRM you can run as two Docker Compose services: the application and PostgreSQL 16. It is a good fit when your team wants to operate its CRM infrastructure and use an open-source core. It is not the self-hosted edition of every Customermates Cloud feature.
A self-hosted CRM runs on servers you control instead of the vendor's cloud: you decide where the application and database live, and you take on updates, backups and security. Whether the code is open source is a separate question about licence rights, covered in the open-source CRM guide. This page covers the operational side for Customermates.
Where follow-up fits. Self-hosting keeps client records, next-step dates, dashboards and MCP on your own servers, so your own AI client can read and update them. It does not have the inbox that puts LinkedIn and email conversations on the client, and it does not have Mate, which drafts the replies. If drafted follow-up on conversations is why you want the CRM, start on Customermates Cloud; self-hosting fits better when control over where the data runs matters more.
Deployment
Database
CRM core
Interfaces
Entitlements
What runs in your infrastructure?
The tracked deployment contains:
- the Customermates application image;
- a PostgreSQL 16 database;
- the core records for contacts, organizations, deals, services and tasks, plus any lists you add; and
- REST, webhooks and MCP access for external AI clients.
The Compose file does not bundle n8n, an AI model, an email-delivery provider or a separate worker. Authentication emails still require the configured external delivery service. If you connect any provider, you operate that integration separately and should review the data it receives.
What is included and excluded?
| Capability | Self-hosted Customermates |
|---|---|
| Contacts, organizations, deals, services and tasks | Included |
| Custom fields, table and Kanban views | Included |
| REST API, webhooks and MCP | Included |
| Entitlement baseline | Starter |
| Hosted Mate assistant and hosted AI credits | Not included |
| Unified inbox and connected messaging accounts | Not included |
| Read-only connected calendar view | Not included |
| Shared connected accounts | Not included |
The unified CRM inbox is a managed-cloud feature from Pro upward. Self-hosting remains focused on the CRM's open-source core and external MCP clients.
Open-source and commercial code boundaries
First-party material outside ee/ is licensed under AGPL-3.0-only. Inside ee/, material is commercially licensed except for the client-side images, fonts, CSS and JavaScript material identified as AGPL Client Material in Section 6 of ee/LICENSE.md. Review both licenses before modifying, redistributing or operating the software for your use case.
That distinction matters when comparing an open-source CRM: a public repository alone does not tell you which code you may use under which terms. If you are weighing other self-hostable projects, the EspoCRM and Twenty comparisons show how their deployment and licence boundaries differ.
What control does self-hosting provide?
You choose where the application and PostgreSQL run and how you configure network access, backups, retention and updates. That is meaningful infrastructure control, but it is not an automatic compliance, security or air-gap guarantee.
Connected services remain separate processing boundaries. OAuth providers, Resend for email, monitoring, workflow tools and external AI providers receive whatever your configuration sends to them. Error diagnostics remain on your server; operator notifications use the recipient and email provider you configure. This is not a blanket no-telemetry promise.
Self-hosted or managed cloud?
| Choose self-hosting when… | Choose managed cloud when… |
|---|---|
| your team can operate Docker and PostgreSQL | you want Customermates to operate the application and database |
| the Starter feature boundary fits | you need the unified inbox or connected calendar view |
| you want external AI clients to use MCP | you want cloud plan entitlements and managed connected accounts |
| you will own updates, backups and recovery | you prefer a subscription with managed operations |
If you want to try Customermates before running your own server, the open source CRM in the cloud or self-hosted page sets both routes side by side, with the free cloud trial as the fastest start.
Records move between installations or from another CRM as XLSX workbooks, one record type at a time and within row limits, or through the REST API, which can also upload files to File fields. An XLSX import carries no attachments and there is no complete account transfer, so plan a larger move as a migration project you validate.
Frequently asked questions
Is Customermates fully open source?
First-party material outside ee/ is AGPL-3.0-only. Inside ee/, the client material identified in Section 6 of ee/LICENSE.md is also AGPL-3.0-only; the remaining first-party material uses the commercial license. Review both license files for the exact boundary.
Does self-hosting include the unified inbox?
No. Self-hosted deployments use the Starter feature set, which has no messaging accounts, unified inbox, shared accounts or connected calendar view. Those capabilities belong to managed-cloud plans from Pro upward.
Can I use AI with the self-hosted CRM?
Yes, through MCP and an external AI client and provider that you select and fund, for example Claude as described in the Claude CRM guide. The cloud-only Mate assistant and hosted AI credits are not part of self-hosting.
Does self-hosting make the CRM GDPR compliant?
No deployment model creates compliance by itself. Self-hosting lets you choose the application and database location, but your organization remains responsible for configuration, providers, contracts, security controls, retention and legal assessment.
What does the official Docker Compose stack contain?
It contains the Customermates application and PostgreSQL 16. Email goes out through Resend with your own API key. n8n, AI models, identity providers and monitoring services are separate when you choose to connect them.
Related pages
Self-Hosting Customermates with Docker Compose
Run Customermates on your own server with Docker Compose: install, .env values, email, sign-up, updates, backups and restore, and what differs from Cloud.
Open Source CRM: How to Compare Self-Hosted Options
Compare open-source CRM options by license, deployment, operations, CRM scope and integrations. See the exact Customermates self-hosted boundary.
Open Source CRM
Customermates is an open source CRM with an AGPL core. Try the managed cloud for 14 days without a card, or run it self-hosted with Docker.
Unified CRM Inbox
One CRM inbox for Gmail, Outlook, IMAP, LinkedIn, WhatsApp, Instagram and Telegram: each conversation on its client, replies drafted. Cloud from Pro.
Customermates
Need LinkedIn and email follow-up too? Try the cloud first
Self-hosting covers client records, REST, webhooks and MCP. For LinkedIn and email conversations on each client and Mate's drafted replies, try Customermates Cloud free for 14 days on Pro, with no credit card. The self-hosted route stays open.
The operator owns infrastructure, updates, backups and connected providers.













