EspoCRM na VPS: como instalar o CRM da empresa
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

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.