Base de Conhecimento

EspoCRM na VPS: como instalar o CRM da empresa

  • espocrm, crm, docker compose, auto-hospedagem, vps
  • Usuários acharam útil: 0

Guia de EspoCRM na VPS: licença, extensões pagas, script oficial com domínio e Let's Encrypt, Docker Compose, portas e firewall, cron, atualização e backup com restauração.

Por Redação Eleven Host · @robson.direitodigital · 6 de novembro de 2026 · 10 min de leitura

Arte da Eleven Host: janela de terminal com o título: EspoCRM na VPS: como instalar o CRM da empresa

Capa da Redação Eleven Host para o guia: EspoCRM na VPS: como instalar o CRM da empresa Arte: Eleven Host

EspoCRM na VPS é a forma de manter o CRM de código aberto EspoCRM no seu próprio servidor, com domínio e HTTPS. Veja o que é, a licença, o script oficial de instalação, o Docker, as portas, a atualização e o backup.

Atualizado em 06/11/2026. Na data deste guia, a 10.0.11, publicada em 23/10/2026, é a versão estável marcada como Latest no GitHub do projeto. Confira se saiu outra. Os blocos marcados como exemplo são montados aqui: confira cada um no seu servidor antes de usar.

O que é o EspoCRM

CRM é o sistema em que a empresa acompanha clientes e negociações. Segundo o GitHub do projeto, o EspoCRM é um CRM gratuito e de código aberto para gerenciar leads, contatos, oportunidades de venda, campanhas de marketing e casos de suporte, com frontend de página única e backend em API REST em PHP.

Segundo a documentação, um lead é quem ainda não é cliente mas pode vir a ser, e o botão Convert gera conta, contato e oportunidade. As oportunidades têm estágios que vão de Prospecting a Closed Won e Closed Lost. Há calendário para reuniões, ligações e tarefas, e contas de e-mail IMAP e SMTP vinculadas aos registros. Para produção, a documentação prefere VPS ou servidor dedicado, e diz que a hospedagem compartilhada pode ter limitações. Se ainda está escolhendo o servidor, o guia completo de servidor VPS explica o que é uma VPS.

Licença e extensões pagas

O núcleo usa a licença GNU AGPLv3. O projeto acrescenta, pela seção 7(b), que os avisos legais mantenham a palavra "EspoCRM" à mostra. O download é gratuito, sem taxa por usuário, e existe licença comercial para quem precisa de uma licença não copyleft.

O fabricante vende extensões à parte. O Advanced Pack traz relatórios, processos de negócio e workflows, e o Sales Pack traz produtos, orçamentos e faturas, compras e estoque. Outras extensões, como Project Management, VoIP, Google, Outlook, Zoom, Stripe, MailChimp, Meeting Scheduler e Intelligence, aparecem na página do fabricante, que também lista MCP e Real Estate como distribuídas de graça. Confira no site do EspoCRM o que cada extensão custa antes de contar com ela.

Requisitos do EspoCRM

A documentação pede PHP de 8.3 a 8.5, e banco MySQL 8.0 ou mais novo, MariaDB 10.6 ou mais novo, ou PostgreSQL 15. O servidor web pode ser Apache, Nginx ou IIS. As extensões PHP obrigatórias são pdo_mysql (ou pdo_pgsql), gd com FreeType, openssl, zip, mbstring, iconv, curl, xml, xmlwriter, exif e bcmath. No php.ini, ela recomenda memory_limit = 256M e post_max_size e upload_max_filesize de 50M.

Quem usa o Docker não instala essas dependências à mão, porque a imagem já as traz.

O CRM da equipe vai ficar em servidor próprio? Confira na loja o que cada plano inclui. Ver as VPS

Caminho principal: o script oficial

O instalador oficial roda em Ubuntu, Debian e Linux Mint, pela linha de comando e com root ou sudo. Ele instala o EspoCRM como aplicação Docker, com Nginx e MariaDB. Recomendamos uma VPS nova, só para o EspoCRM. Antes de rodar, aponte o DNS do domínio para o IP da VPS: o Let's Encrypt só emite o certificado se o nome já chegar até o servidor. Para domínios registrados conosco, o DNS gerenciado grátis na rede da Cloudflare fica no painel da área do cliente.

Um exemplo de comandos, com domínio e e-mail fictícios que você troca pelos seus. O primeiro baixa o instalador; o segundo roda com certificado do Let's Encrypt:

wget -N https://github.com/espocrm/espocrm-installer/releases/latest/download/install.sh

sudo bash install.sh -y --ssl --letsencrypt --domain=crm.seudominio.com.br --email=voce@seudominio.com.br

Sem o -y, o instalador faz as perguntas na tela. Antes de seguir, ele avisa que vai instalar os pré-requisitos, entre eles Docker, Nginx, PHP e MariaDB, e se recusa a continuar se a porta do modo escolhido já estiver ocupada: a 80 em HTTP, a 443 com SSL. Também detecta uma instalação anterior em /var/www/espocrm.

No fim, o instalador mostra a senha do administrador, gerada por ele. Anote na hora. Depois entre no sistema e confira o Site URL em Administração > Settings.

Cuidado com a opção --clean: ela apaga a instalação existente e começa outra. O instalador faz um backup e remove o diretório da instalação sem pedir confirmação extra.

Há três modos. Let's Encrypt, que é o exemplo acima. Certificado próprio: troque fullchain.pem e privkey.pem em /var/www/espocrm/data/nginx/ssl/cert/ e rode /var/www/espocrm/restart.sh espocrm-nginx. E HTTP, para quem ainda não tem domínio. Para trocar de modo, rode o instalador com as novas opções e ajuste o Site URL em Administração > Settings.

Portas abertas e o firewall

No Docker Compose do script, o espocrm-nginx publica a 80 e a 443 (com Let's Encrypt), e o espocrm-websocket publica a 8080. Nenhuma está presa ao endereço local: as três ficam abertas ao público. O banco não publica porta.

Segundo a documentação do Docker, publicar porta é inseguro por padrão, e as portas publicadas passam por cima das regras do ufw, porque o tráfego é roteado na tabela nat antes do firewall. Portas não publicadas ficam bloqueadas para fora. Ou seja, fechar a porta no ufw não basta. Para prender uma porta ao próprio servidor, a Docker mostra o endereço local no mapeamento. Um exemplo, no Compose:

- 127.0.0.1:8080:80

Recomendamos conferir de fora do servidor quais portas respondem. Se mexer na publicação da 8080 do WebSocket, confira se ele continua funcionando.

Alternativa: Docker Compose

A documentação do EspoCRM recomenda o Compose para produção com Docker. Ela usa a imagem espocrm/espocrm, mas o Docker Hub marca esse repositório como não recomendado para novas instalações e aponta a Docker Official Image espocrm. Como as duas informações divergem, confira as duas páginas antes de escolher. Recomendamos fixar a tag, em vez de latest, tanto no espocrm quanto no mariadb, porque um pull pode trocar a versão, e fazer backup antes de atualizar.

Para esta alternativa, o Docker e o plugin Compose precisam estar instalados antes. Copie o Compose completo da página de instalação em Docker da documentação, com os serviços do banco, do espocrm, do espocrm-daemon e do espocrm-websocket. As senhas ali são exemplos: troque-as. O exemplo publica a 8080:80 e a 8081:8080, abertas ao público e sem TLS, então não o trate como pronto para produção. Um exemplo de comandos para a pasta:

mkdir espocrm-docker

cd espocrm-docker/

Salve o Compose nessa pasta e edite o arquivo antes de subir os serviços. As variáveis ESPOCRM_DATABASE_*, ESPOCRM_ADMIN_* e ESPOCRM_SITE_URL só valem na primeira execução; as ESPOCRM_CONFIG_* valem a cada início. Sem variável, o administrador é admin com a senha password, e o banco também usa password. A documentação destaca o ESPOCRM_SITE_URL como muito importante: na VPS, use o endereço real. O daemon faz o trabalho de fundo, e a imagem já o inclui. Com o arquivo editado, e o DNS apontado se for usar domínio, suba os serviços:

docker compose up -d

Para HTTPS, a documentação mostra o Caddy: o ESPOCRM_SITE_URL vira https://{YOUR_DOMAIN}, o ESPOCRM_CONFIG_WEB_SOCKET_URL vira wss://{YOUR_DOMAIN}/ws, os serviços do EspoCRM passam a usar expose em vez de publicar portas, e só o Caddy publica a 80 e a 443. O DNS do domínio precisa apontar para a VPS antes de subir. O Caddyfile do exemplo é este:

YOUR_DOMAIN {

reverse_proxy espocrm:80

reverse_proxy /ws espocrm-websocket:8080 {

header_up Host {host}

header_up X-Real-IP {remote}

header_up X-Forwarded-For {remote}

header_up X-Forwarded-Proto {scheme}

}

}

A indentação do Caddyfile pode sumir ao copiar daqui; confira linha a linha. A documentação também traz um exemplo com Traefik, que publica a 8080 com --api.insecure=true: não use esse exemplo sem tratar isso. Há ainda a instalação manual com Nginx, com baixar o pacote, criar o banco, seguir o assistente no navegador e configurar o cron. Nela, confira em Administração > System Requirements os pacotes PHP, porque a lista da página do Nginx está sem o bcmath e o xml.

Para comparar com outros sistemas de empresa em servidor próprio, há o guia de Twenty CRM na VPS e o guia de Dolibarr na VPS, ERP e CRM da empresa.

Depois de instalar: cron, daemon e WebSocket

Na instalação manual, a linha do cron aparece em Administração > Scheduled Jobs, e você a instala com crontab -e -u USUÁRIO_DO_SERVIDOR_WEB. O exemplo da documentação é:

* * * * * /usr/bin/php -f /var/www/html/espocrm/cron.php > /dev/null 2>&1

Com Docker, o daemon cuida do trabalho de fundo; confira os jobs em Administração > Scheduled Jobs. Para receber e-mail, o cron é necessário. Crie uma conta Group Email Account como padrão e ponha o endereço em Outbound Emails > System Email Address.

Para o WebSocket, ative "Use WebSocket" em Administração > Settings. Ele exige a extensão ZMQ, e a imagem Docker já traz ZMQ e ev. A porta padrão é a 8080 sem SSL e a 8443 com SSL.

Segurança: troque a senha do admin logo

Troque logo a senha do administrador gerada na instalação. A documentação de segurança pede senha com no mínimo 10 caracteres (8 se o 2FA for obrigatório), com dígitos, maiúsculas e minúsculas, e orienta ativar e exigir o 2FA, não usar o admin no dia a dia, desligar a recuperação de senha para administradores, ligar o modo no-exposure e reduzir o tempo de sessão ociosa. Também sugere uma lista de IPs em Authentication > Access.

Atualizar o EspoCRM

A documentação manda fazer backup antes, ligar o Modo de Manutenção e desligá-lo depois, conferir o espaço em disco e rodar como o usuário do servidor web ou root. Versões X e Y podem exigir ajuste em extensões e customizações, e a documentação trata as versões Z, de correção, como atualização tranquila. A documentação desaconselha atualizar pela interface. Os comandos oficiais:

sudo /var/www/espocrm/command.sh upgrade

docker compose pull && docker compose up -d

php command.php upgrade

O primeiro é do script; o segundo, do Docker (com a tag fixa, troque a tag no arquivo antes do pull); o terceiro, da instalação manual, e deve ser repetido se houver versão mais nova, sem fechar o terminal. Para atualizar o próprio command.sh, use install.sh --command.

Backup e restauração

No script, a instalação fica em /var/www/espocrm: os dados do EspoCRM, do MariaDB e do Nginx, o docker-compose.yaml e o command.sh. Os comandos oficiais:

sudo /var/www/espocrm/command.sh backup "DIRETÓRIO"

sudo /var/www/espocrm/command.sh restore "ARQUIVO_DO_BACKUP"

Para restaurar num servidor novo, baixe o instalador e rode a preparação do ambiente; depois restaure. Se der erro de rede, rode a opção de rede e repita. Os dois comandos:

sudo bash install.sh --environment

sudo bash install.sh --network

Ao final, confira na página do script como reativar a renovação do certificado.

No Docker, a documentação usa um script de backup que roda no servidor. Confira o conteúdo dele antes de executar:

wget https://raw.githubusercontent.com/espocrm/documentation/stable/docs/_static/scripts/backup-docker-container.sh

sudo bash backup-docker-container.sh CONTAINER_NAME ./BACKUP_DIR

Onde guardar o backup

Recomendamos copiar o backup para fora do servidor e guardá-lo em local protegido, porque ele pode conter configurações e credenciais. Teste a restauração antes de precisar dela.

Escolher a VPS do CRM

O servidor do CRM pode ser novo e separado de outros projetos.

Outra VPS para separar o CRM do resto é uma possibilidade? Confira na loja o que cada plano inclui. Conhecer as VPS

Perguntas frequentes

O EspoCRM é gratuito?

O núcleo é gratuito e de código aberto, com licença AGPLv3. Algumas extensões do fabricante são pagas e têm outra licença.

Qual o caminho principal para instalar?

Aqui, é o script oficial, que pede o domínio e o e-mail e emite o certificado do Let's Encrypt. Ele roda em Ubuntu, Debian e Linux Mint.

Fechar a porta no ufw protege o Docker?

Não. Segundo a documentação do Docker, as portas publicadas passam por cima das regras do ufw.

Preciso trocar a senha do administrador?

Sim, troque logo. No Docker, sem variável de ambiente, o padrão é admin com a senha password.

Esta resposta lhe foi útil?

Artigos Relacionados