# Deploy Customermates with Easypanel

URL: /templates/customermates

Customermates is an open-source CRM for contacts, organizations, deals, services and tasks. Lists, fields and relationships are configurable, and every workspace has a REST API, webhooks and an MCP endpoint for external AI clients. Self-hosted, it runs on PostgreSQL and uses the Starter feature set.

## Installation notes

Open the app domain, go to /auth/signup, register and choose Create a new workspace; your account becomes Admin. Email goes out only through Resend, so set RESEND_API_KEY and RESEND_OPERATOR_EMAIL (a sender on a domain verified in Resend) in the Environment tab, or new accounts are held after 24 hours until their email is verified. Anyone who can reach the domain can register; limit access at the proxy if the instance should serve one team only. This template runs the Starter feature set, with no connected messaging, calendar sync or hosted assistant. External AI clients connect through MCP at /api/v1/mcp. Trash is only emptied after 30 days if /api/cron/lifecycle is called once a day with CRON_SECRET as a bearer token (see Which scheduled jobs must I run in the self-hosting documentation). The image tag is pinned to a build of the project's main branch; migrations only move forward, so take a database backup before changing the tag.

## Benefits

### Open Source Core

The Community Edition is licensed under AGPL-3.0. You run the official image and keep the data in your own PostgreSQL database.

### Bring Your Own AI

Connect Claude, ChatGPT, Cursor, Codex or Gemini to your own instance through the MCP endpoint, with your own AI provider.

### Simple Operations

One app container and one PostgreSQL database. Migrations run on every start and there is no separate worker or cache service.

## Features

### Configurable Lists

Create the lists, fields and relationships your team needs, with table, board and calendar views.

### REST API, Webhooks and MCP

Every workspace has an OpenAPI reference, webhooks for record events and an MCP endpoint at /api/v1/mcp.

### Excel Import and Export

Move records in and out one list at a time as Excel workbooks.

### Members, Roles and Activity Log

Invite teammates, set per role permissions and review changes in the activity log.

### Several Workspaces per Login

One instance holds any number of isolated workspaces, each with its own data model, members and API keys.

## Configuration

- `appServiceName` (App Service Name, required): customermates

- `appServiceImage` (App Service Image, required): ghcr.io/customermates/customermates:sha-4f4d61c

- `resendApiKey` (Resend API Key (optional, needed for email)): Set during installation

- `resendOperatorEmail` (Resend Sender Email (optional, a domain verified in Resend)): mail@your-company.com

## Services

- customermates: app (ghcr.io/customermates/customermates:sha-4f4d61c)

- customermates-db: postgres

## Resources

- [Website](https://customermates.com)

- [Documentation](https://customermates.com/docs/self-hosting)

- [Github](https://github.com/customermates/customermates)

- [Template source](https://github.com/easypanel-io/templates/tree/main/templates/customermates)