Instalação e configuração do Mautic passo a passo

Instalar o Mautic corretamente é o fundamento de toda a operação de automação de marketing. Uma instalação mal configurada resulta em problemas de entregabilidade, lentidão, falhas de rastreamento e dores de cabeça técnicas que comprometem os resultados das campanhas. Por outro lado, um Mautic bem instalado e configurado oferece uma plataforma robusta e escalável — capaz de competir com soluções pagas muito mais caras.

Este guia cobre o processo completo de instalação e configuração do Mautic: desde os requisitos de servidor até as configurações essenciais de email, CRON jobs e segurança que você precisa fazer antes de criar sua primeira campanha.

Instalação do Mautic em 30 segundos (resumo rápido)

Requisitos: PHP 8.0+, MySQL 5.7+/MariaDB 10.3+, Apache/Nginx, 2GB RAM mínimo.
Download: Baixe o pacote em mautic.org/download ou instale via Composer.
Configuração: Banco de dados, usuário admin e configurações básicas via instalador web.
CRON Jobs: Configure 6 CRONs essenciais para o funcionamento completo.
Email: Configure SMTP (Amazon SES, Mailgun) e registros DNS (SPF, DKIM, DMARC).

Requisitos de servidor para o Mautic

Antes de instalar, garanta que o servidor atende a todos os requisitos. Usar especificações abaixo do mínimo é a causa mais comum de problemas de performance.

Requisitos de software

PHP: 8.0 ou superior (8.1 recomendado). Extensões obrigatórias: curl, dom, gd, intl, mbstring, openssl, pdo_mysql, zip.
Banco de dados: MySQL 5.7+ ou MariaDB 10.3+.
Servidor web: Apache 2.4+ com mod_rewrite habilitado, ou Nginx.
Composer: Para instalação e gerenciamento de dependências.

Requisitos de hardware recomendados

Até 10.000 contatos: VPS com 2 vCPUs e 4 GB de RAM.
10.000 a 50.000 contatos: 4 vCPUs e 8 GB de RAM.
Acima de 50.000 contatos: Banco de dados em servidor separado; considere Redis para cache.
Disco: SSD é obrigatório para performance adequada do MySQL.

Instalando o Mautic

Opção 1: Download do pacote ZIP (recomendado para iniciantes)

Acesse mautic.org/download e baixe o pacote da versão mais recente.
Faça upload do ZIP para o servidor e extraia no diretório raiz do domínio (ex.: /var/www/mautic).
Ajuste as permissões dos diretórios: chmod -R 755 /var/www/mautic e chown -R www-data:www-data /var/www/mautic.
Crie o banco de dados MySQL: CREATE DATABASE mautic CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
Acesse o domínio no navegador — o instalador web iniciará automaticamente.

Opção 2: Instalação via Composer (recomendado para desenvolvedores)

composer create-project mautic/recommended-project:^5 mautic --no-interaction
cd mautic
php bin/console mautic:install --force \
  --db_host=localhost \
  --db_name=mautic \
  --db_user=mautic_user \
  --db_password=SENHA \
  --admin_email=seu@email.com \
  --admin_password=SENHA_ADMIN

Configuração do Apache/Nginx

Virtual Host Apache

<VirtualHost *:443>
  ServerName mautic.seudominio.com.br
  DocumentRoot /var/www/mautic
  <Directory /var/www/mautic>
    AllowOverride All
    Require all granted
  </Directory>
  SSLEngine on
  SSLCertificateFile /etc/ssl/certs/mautic.crt
  SSLCertificateKeyFile /etc/ssl/private/mautic.key
</VirtualHost>

Configurando os CRON Jobs obrigatórios

Os CRON jobs são essenciais — sem eles, o Mautic não dispara emails, não processa campanhas e não atualiza segmentos. Configure-os no crontab do servidor (crontab -e):

Comando CRON	Frequência recomendada	Função
`mautic:campaigns:trigger`	A cada 5 min	Processa ações de campanha pendentes
`mautic:emails:send`	A cada 5 min	Despacha emails da fila de envio
`mautic:campaigns:rebuild`	A cada 30 min	Adiciona/remove contatos das campanhas
`mautic:segments:update`	A cada 30 min	Recalcula membros dos segmentos
`mautic:contacts:deduplicate`	Uma vez por dia	Remove contatos duplicados
`mautic:maintenance:cleanup`	Uma vez por semana	Remove logs e dados antigos

Exemplo de configuração completa no crontab:

*/5 * * * * php /var/www/mautic/bin/console mautic:campaigns:trigger --no-interaction
*/5 * * * * php /var/www/mautic/bin/console mautic:emails:send --no-interaction
*/30 * * * * php /var/www/mautic/bin/console mautic:campaigns:rebuild --no-interaction
*/30 * * * * php /var/www/mautic/bin/console mautic:segments:update --no-interaction
0 3 * * * php /var/www/mautic/bin/console mautic:contacts:deduplicate --no-interaction
0 2 * * 0 php /var/www/mautic/bin/console mautic:maintenance:cleanup --days-old=90 --no-interaction

Configuração de email e entregabilidade

Acesse Admin → Configuration → Email Settings. Configure o SMTP do seu provedor de email transacional:

Amazon SES (recomendado para volume)

Server: email-smtp.us-east-1.amazonaws.com (ou sua região)
Port: 587 (STARTTLS)
Username e Password: credenciais SMTP geradas no painel SES
Custo: USD 0,10 por 1.000 emails (muito econômico para grandes volumes)

Registros DNS obrigatórios para entregabilidade

SPF: Autoriza os servidores de envio do seu domínio. Exemplo: v=spf1 include:amazonses.com ~all
DKIM: Assina digitalmente os emails para provar autenticidade. Configure as chaves fornecidas pelo SES ou Mailgun no DNS do domínio.
DMARC: Define política para emails que falham SPF/DKIM. Comece com: v=DMARC1; p=none; rua=mailto:dmarc@seudominio.com.br

Não pule a configuração de HTTPS
O Mautic precisa obrigatoriamente de HTTPS para funcionar corretamente. Sem SSL, o script de tracking é bloqueado por navegadores modernos, links de email são marcados como inseguros e a integração com Facebook Lead Ads não funciona. Use o Let’s Encrypt (gratuito) para obter o certificado SSL — certbot automatiza todo o processo em servidores Ubuntu/Debian.

Configurações essenciais pós-instalação

Após a instalação básica, configure em Admin → Configuration:

Site URL: Defina a URL completa do Mautic (com HTTPS).
Timezone e Locale: Defina o fuso horário e localização para o Brasil.
Unsubscribe Message: Personalize a mensagem de descadastro em português.
Do Not Track (DNT): Defina como o Mautic responde ao header DNT do navegador.
Bounce Handling: Configure o email ou mailbox para receber notificações de bounce.

Perguntas frequentes sobre instalação do Mautic

Posso instalar o Mautic no mesmo servidor do WordPress?

Tecnicamente sim, mas não é recomendado para produção. O Mautic e o WordPress disputarão recursos de servidor (CPU, RAM, MySQL), o que prejudica a performance de ambos. Para testes e uso com volume baixo, é viável. Para produção com volume significativo de emails e contatos, use servidores separados ou pelo menos bancos de dados separados.

Existe uma opção de Mautic hospedado (sem precisar instalar)?

Sim. A Mautic.com oferece planos de hospedagem gerenciada do Mautic. Existem também provedores terceiros que oferecem Mautic hospedado. A vantagem é eliminar a complexidade de configuração e manutenção do servidor; a desvantagem é o custo mensal. Para quem tem familiaridade técnica, o self-hosted é muito mais econômico.

Como atualizar o Mautic para uma nova versão?

O Mautic tem um atualizador integrado em Admin → Update. Porém, sempre faça backup completo (arquivos + banco de dados) antes de atualizar. Para atualizações de versão maior (ex.: 4.x para 5.x), leia as notas de migração na documentação oficial, pois podem haver mudanças incompatíveis que requerem ajustes manuais.

O Mautic funciona com PHP 8.2 e 8.3?

O Mautic 5.x tem suporte oficial a PHP 8.0, 8.1 e 8.2. A compatibilidade com PHP 8.3 depende da versão específica do Mautic — verifique as notas de release da versão que você planeja instalar. Em geral, o Mautic 5.1+ tem suporte completo a PHP 8.2 e está em processo de certificação para 8.3.

Qual a diferença entre o Mautic Open Source e o Mautic Cloud?

O Mautic Open Source é o software gratuito que você instala e gerencia em seu próprio servidor. O Mautic Cloud (mautic.com) é a versão hospedada e gerenciada pela própria organização Mautic, com planos pagos que incluem suporte, atualizações automáticas e infraestrutura administrada. O código-base é o mesmo — a diferença está em onde e como a plataforma é hospedada.

Conclusão

Uma instalação bem feita do Mautic é o alicerce de toda a operação de automação de marketing. Invista tempo nos CRONs, na configuração de email e nos registros DNS — esses elementos determinam a entregabilidade e a performance da plataforma no longo prazo.

Após a instalação, explore os recursos da plataforma gradualmente: comece com formulários e emails simples antes de criar campanhas complexas. Para mais conteúdos sobre Mautic, acesse os artigos de Mautic no atraca.com.br ou consulte a documentação oficial de instalação do Mautic.

Perguntas frequentes sobre instalação do Mautic (FAQ)

Quais são os requisitos mínimos para instalar o Mautic?

O Mautic requer PHP 7.4 ou superior, MySQL 5.7+ ou MariaDB 10.3+, e um servidor web Apache ou Nginx. Recomenda-se pelo menos 2 GB de RAM e 10 GB de espaço em disco para uma instalação com volume moderado de contatos.

O Mautic pode ser instalado em hospedagem compartilhada?

Tecnicamente é possível, mas não recomendado. A hospedagem compartilhada geralmente possui limitações de memória, tempo de execução e acesso ao CRON que prejudicam o funcionamento correto do Mautic. O ideal é um VPS ou servidor dedicado.

Como configurar os CRON jobs do Mautic?

Os CRON jobs são essenciais para o Mautic processar filas de emails, atualizar segmentos e executar campanhas. Os principais são: mautic:segments:update, mautic:campaigns:trigger e mautic:emails:send. Devem ser configurados para executar a cada 1-5 minutos.

É possível migrar o Mautic para outro servidor?

Sim. Basta fazer backup do banco de dados e da pasta de instalação, transferir para o novo servidor, atualizar o arquivo de configuração local.php com as novas credenciais do banco e ajustar as permissões de pasta.

O Mautic é gratuito?

Sim, o Mautic é uma ferramenta open-source e gratuita. Você paga apenas pela infraestrutura (servidor, domínio) e, opcionalmente, por serviços de envio de email como Amazon SES ou SendGrid.

Instalação e configuração do Mautic passo a passo