Laboratório: EspoCRM em produção local com funil de vendas e integração de e-mail

Roteiro para estudo em ambiente de laboratório ou de teste. Execute apenas em equipamentos, redes e contas que você tenha autorização para usar, com backup e homologação próprios. Comandos podem causar indisponibilidade ou perda de dados. Software e marcas citados pertencem aos seus titulares. Termos de Uso.

Duração estimada

120 min

Passos

13

Validações

5

Versões da documentação consultada

EspoCRM 7.5.6 · MariaDB a versão estável atual · Apache HTTP Server a versão estável atual · PHP consulte a documentação do EspoCRM para requisitos

Topologia

Uma máquina virtual Linux (192.168.56.10) roda Apache, PHP, MariaDB e EspoCRM. Usuários acessam via navegador na mesma rede. O EspoCRM conecta-se a um servidor SMTP/IMAP externo (exemplo: mail.dominio.local).

┌─────────────────────────────┐
│  Usuário (192.168.56.20)    │
└─────────────┬───────────────┘
              │ HTTP/HTTPS
┌─────────────▼───────────────┐
│ EspoCRM VM (192.168.56.10)  │
│ Apache + PHP + MariaDB      │
└─────────────┬───────────────┘
              │ SMTP/IMAP
┌─────────────▼───────────────┐
│ mail.dominio.local          │
└─────────────────────────────┘

Equipamentos e software

Roteiro

1. Preparar o sistema operacional

   Atualize o sistema e instale utilitários básicos. Isso garante ambiente limpo e atualizado.

   sudo apt update && sudo apt upgrade -y
   sudo apt install unzip wget nano -yCopiar

   O que você deve ver: Sistema atualizado, utilitários instalados.

2. Instalar Apache

   O EspoCRM depende de um servidor web. Apache é o mais comum em ambientes Linux.

   sudo apt install apache2 -yCopiar

   O que você deve ver: Apache instalado e rodando em http://localhost.

3. Instalar PHP e extensões

   EspoCRM exige PHP e módulos específicos. Consulte a documentação para versões suportadas.

   sudo apt install php php-mysql php-xml php-mbstring php-zip php-curl php-gd php-imap -yCopiar

   O que você deve ver: PHP e extensões instaladas.

4. Instalar MariaDB

   O banco de dados armazena todas as entidades e registros do CRM.

   sudo apt install mariadb-server -yCopiar

   O que você deve ver: MariaDB instalado e rodando.

5. Configurar banco de dados para EspoCRM

   Crie banco e usuário dedicados para isolar o ambiente do CRM.

   sudo mysql -u root
   CREATE DATABASE espocrm CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
   CREATE USER 'espouser'@'localhost' IDENTIFIED BY 'senha-forte';
   GRANT ALL PRIVILEGES ON espocrm.* TO 'espouser'@'localhost';
   FLUSH PRIVILEGES;
   EXIT;Copiar

   O que você deve ver: Banco e usuário criados.

6. Baixar e descompactar EspoCRM

   Obtenha o pacote oficial do EspoCRM e coloque-o no diretório do Apache.

   cd /var/www/html
   sudo wget https://github.com/espocrm/espocrm/archive/refs/tags/7.5.6.zip
   sudo unzip 7.5.6.zip
   sudo mv espocrm-7.5.6 espocrm
   sudo chown -R www-data:www-data espocrm
   sudo chmod -R 755 espocrmCopiar

   O que você deve ver: Arquivos do EspoCRM no diretório /var/www/html/espocrm.

7. Configurar Apache para EspoCRM

   Crie um VirtualHost dedicado para isolar o acesso ao CRM.

   sudo nano /etc/apache2/sites-available/espocrm.confCopiar

   O que você deve ver: Arquivo de configuração criado.

8. Conteúdo do VirtualHost

   Insira as diretivas para servir o EspoCRM.

   <VirtualHost *:80>
       ServerAdmin admin@dominio.local
       DocumentRoot /var/www/html/espocrm
       ServerName crm.dominio.local
       <Directory /var/www/html/espocrm>
           AllowOverride All
           Require all granted
       </Directory>
       ErrorLog ${APACHE_LOG_DIR}/espocrm_error.log
       CustomLog ${APACHE_LOG_DIR}/espocrm_access.log combined
   </VirtualHost>Copiar

   O que você deve ver: VirtualHost configurado.

9. Ativar site e módulos do Apache

   Habilite o novo site e o mod_rewrite, necessário para URLs amigáveis.

   sudo a2ensite espocrm
   sudo a2enmod rewrite
   sudo systemctl reload apache2Copiar

   O que você deve ver: Site ativado, Apache recarregado.

10. Instalar EspoCRM via navegador

    Acesse http://crm.dominio.local e siga o instalador web. Informe dados do banco, admin e-mail e senha.

    O que você deve ver: Tela de login do EspoCRM ao final.

11. Configurar entidade Oportunidade e Funil de Vendas

    No menu de administração, ajuste os estágios do funil de vendas conforme o processo comercial desejado.

    O que você deve ver: Funil de vendas visível e ajustado em Oportunidades.

12. Configurar e-mail SMTP/IMAP

    No menu de e-mail, configure conta SMTP/IMAP para envio e recebimento de e-mails comerciais.

    O que você deve ver: Envio e recebimento de e-mails funcionando no CRM.

13. Criar workflow simples

    No menu de automação, crie um workflow que envie e-mail automático ao criar uma nova oportunidade.

    O que você deve ver: Workflow criado e acionado ao criar novas oportunidades.

Como saber que funcionou

Troubleshooting

Segurança e hardening

• Altere a senha padrão do admin imediatamente após a instalação.
• Restrinja o acesso ao diretório do EspoCRM apenas ao usuário do Apache.
• Use HTTPS no VirtualHost para proteger credenciais e dados trafegados.
• Desabilite o acesso remoto ao MariaDB (bind-address = 127.0.0.1).
• Mantenha o sistema operacional e todos os softwares atualizados.
• Considere limitar o acesso ao CRM por firewall local.

Checklist final

• Sistema operacional atualizado
• Apache, PHP e MariaDB instalados
• Banco de dados dedicado criado
• Arquivos do EspoCRM no diretório correto
• VirtualHost configurado e ativo
• EspoCRM instalado e acessível via navegador
• Funil de vendas configurado
• E-mail integrado (SMTP/IMAP)
• Workflow funcional