CRM self hosted: registros de clientes e próximos passos nos seus servidores

O Customermates é um CRM self hosted que você pode rodar como dois serviços do Docker Compose: a aplicação e o PostgreSQL 16. Ele serve quando a sua equipe quer operar a infraestrutura do próprio CRM e usar um núcleo de código aberto. Não é a edição self hosted de todos os recursos do Customermates Cloud.

Um CRM self hosted roda em servidores que você controla, em vez de na nuvem do fornecedor: você decide onde ficam a aplicação e o banco de dados e assume as atualizações, os backups e a segurança. Saber se o código é aberto é outra questão, sobre direitos de licença, tratada no guia de CRM open source. Esta página trata do lado operacional no Customermates.

Onde entra o follow-up. O self hosting mantém nos seus servidores os registros de clientes, as datas dos próximos passos, os painéis e o MCP, para que o seu próprio cliente de IA possa lê-los e atualizá-los. Ele não tem a caixa de entrada que coloca as conversas de LinkedIn e e-mail no cliente e não tem o Mate, que escreve os rascunhos de resposta. Se o que você quer do CRM é o follow-up em rascunho nas conversas, comece pelo Customermates Cloud; o self hosting combina mais quando o controle sobre onde os dados rodam pesa mais.

O que roda na sua infraestrutura?

A implantação do repositório contém:

• a imagem da aplicação do Customermates;
• um banco de dados PostgreSQL 16;
• os registros básicos de contatos, organizações, negócios, serviços e tarefas, mais as listas que você adicionar; e
• REST, webhooks e acesso MCP para clientes de IA externos.

O arquivo Compose não inclui n8n, modelo de IA, provedor de envio de e-mails nem um worker separado. Os e-mails de autenticação ainda dependem do serviço de envio externo configurado. Se você conectar algum provedor, você opera essa integração separadamente e deve revisar os dados que ele recebe.

O que está incluído e o que fica de fora?

A caixa de entrada unificada do CRM é um recurso da nuvem gerenciada a partir do Pro. O self hosting continua focado no núcleo open source do CRM e nos clientes MCP externos.

Limites entre código aberto e código comercial

O material próprio fora de ee/ é licenciado sob AGPL-3.0-only. Dentro de ee/, o material tem licença comercial, exceto as imagens, fontes, CSS e JavaScript do lado do cliente identificados como AGPL Client Material na Seção 6 de ee/LICENSE.md. Leia as duas licenças antes de modificar, redistribuir ou operar o software no seu caso.

Essa distinção importa quando você compara um CRM open source: um repositório público, sozinho, não diz qual código você pode usar e em quais condições. Se você está avaliando outros projetos que dá para hospedar por conta própria, as comparações com EspoCRM e Twenty mostram como diferem os limites de implantação e de licença de cada um.

Que controle o self hosting oferece?

Você escolhe onde rodam a aplicação e o PostgreSQL e como configura o acesso de rede, os backups, a retenção e as atualizações. É um controle relevante sobre a infraestrutura, mas não é uma garantia automática de conformidade, de segurança ou de isolamento da rede.

Os serviços conectados continuam sendo limites de tratamento de dados separados. Provedores de OAuth, Resend para e-mail, monitoramento, ferramentas de fluxo de trabalho e provedores de IA externos recebem o que a sua configuração envia a eles. O diagnóstico de erros fica no seu servidor; as notificações ao operador usam o destinatário e o provedor de e-mail que você configurar. Isso não é uma promessa geral de ausência de telemetria.

Self hosted ou nuvem gerenciada?

Se você quer testar o Customermates antes de operar o seu próprio servidor, a página CRM open source na nuvem ou self hosted coloca as duas opções lado a lado, com o teste gratuito na nuvem como o começo mais rápido.

Os registros passam de uma instalação para outra, ou de outro CRM, como planilhas XLSX, um tipo de registro por vez e dentro dos limites de linhas, ou pela API REST, que também pode enviar arquivos para campos de Arquivo. Uma importação de XLSX não leva anexos e não existe transferência completa da conta, então planeje uma mudança maior como um projeto de migração que você valida.

Como instalar um CRM self hosted com Docker Compose?

Um CRM auto hospedado como o Customermates sobe a partir de dois arquivos, docker-compose.yml e .env, com docker compose up -d. Você baixa os dois do repositório do Customermates com curl, sem git clone e sem etapa de build. Os pré-requisitos são Docker com Docker Compose v2 e, só para usar HTTPS, um nome de domínio.

1. Baixe o docker-compose.yml e o modelo do .env.
2. Preencha o .env antes da primeira inicialização: no mínimo a senha do PostgreSQL, o segredo de autenticação, o BASE_URL e a chave do serviço de envio de e-mails. Sem uma chave de e-mail que funcione, nenhum e-mail sai e ninguém consegue confirmar o endereço.
3. Rode docker compose up -d. A primeira inicialização leva cerca de um minuto, enquanto as migrações do banco rodam.
4. Abra <BASE_URL>/auth/signup, cadastre-se e crie o primeiro espaço de trabalho; essa conta vira administradora.

Os passos completos, as variáveis do .env, o proxy reverso com HTTPS, as atualizações e os backups estão no guia de self hosting. Qualquer pessoa que alcance o BASE_URL consegue se cadastrar, então, se a instância for só da sua equipe, limite o acesso com VPN, lista de IPs permitidos ou autenticação no proxy.

Perguntas frequentes