Como Instalar Mautic: Guia Completo com 4 Métodos

Por Que Instalar o Mautic no Seu Servidor

Se você chegou até aqui, provavelmente já entende o potencial do Mautic como plataforma de email marketing e automação. A grande vantagem de instalar o Mautic no seu próprio servidor é o controle total sobre seus dados, customização completa e economia significativa comparado a plataformas pagas. Depois de anos trabalhando com Mautic em dezenas de projetos, aprendi que a instalação correta faz toda diferença entre uma ferramenta que funciona perfeitamente e outra que trava constantemente.

Neste guia, vou te mostrar 4 métodos diferentes para instalar o Mautic, desde o mais simples (instalador automático) até opções mais avançadas para quem busca total controle. Escolha o método que faz mais sentido para o seu nível técnico e necessidades.

💡 Dica do Gabriel

Neste momento, não vamos entrar em detalhes sobre versões específicas do Mautic. Em breve farei uma atualização completa focando exclusivamente no Mautic 6 com aulas atualizadas. O importante agora é você ter uma instalação estável e funcional.

Pré-requisitos Essenciais Para Qualquer Método

Antes de começar a instalação, você precisa ter três elementos básicos configurados. Sem eles, nenhum método vai funcionar.

1. Servidor VPS ou Cloud

O Mautic precisa rodar em um servidor próprio. As opções mais comuns são VPS (Servidor Virtual Privado) ou cloud servers. Para quem está começando, recomendo um servidor com pelo menos 2GB de RAM e 20GB de armazenamento. Se você ainda não tem um servidor, confira este guia sobre qual o melhor provedor cloud para suas necessidades.

2. Domínio ou Subdomínio

Você vai precisar de um domínio configurado para acessar seu Mautic. A maioria das pessoas usa um subdomínio como mautic.seusite.com ou email.seusite.com. Se ainda não tem um domínio registrado, veja como fazer o registro de domínio corretamente.

3. DNS Configurado

Seu domínio precisa apontar para o IP do servidor. Isso é feito através de registros DNS do tipo A (para IPv4) e AAAA (para IPv6). Recomendo usar o Cloudflare para gerenciar seu DNS pela facilidade e proteção adicional. Aqui está um guia completo sobre configuração de DNS no Cloudflare.

⚠️ Atenção

Aguarde pelo menos 5-10 minutos após configurar o DNS antes de prosseguir com a instalação. A propagação dos registros DNS pode levar algum tempo.

Método 1: Instalação Automática com GW Hosting (Recomendado para Iniciantes)

Este é o método mais simples e rápido para ter o Mautic funcionando. Se você não tem experiência técnica ou quer economizar tempo, este é o caminho. O Gerenciando Web Hosting oferece um instalador automático que cuida de 90% da configuração para você.

Vantagens Deste Método

  • Instalação em menos de 10 minutos: O instalador automatiza todo o processo técnico
  • Configurações otimizadas: Limites de envio, tarefas Cron e segurança já vêm configurados
  • Sem linha de comando: Tudo é feito através de interface visual
  • Suporte especializado: Equipe que entende de Mautic para te ajudar

Vídeo: Instalação Automática Passo a Passo

Antes de começar, assista este vídeo onde mostro o processo completo:

Passo 1: Adicionar Domínio no Painel

No painel do GW Hosting, clique em Adicionar Domínio e insira o domínio ou subdomínio onde quer instalar o Mautic. Por exemplo: mautic.seusite.com. O sistema vai automaticamente gerar o endereço IP que você precisa configurar no DNS.

Passo 2: Configurar DNS

Vá até o seu gerenciador de DNS (Cloudflare, por exemplo) e adicione dois registros apontando para o IP fornecido:

  • Registro A (IPv4): Nome = mautic, Conteúdo = IP do servidor
  • Registro AAAA (IPv6): Nome = mautic, Conteúdo = IPv6 do servidor

Desative o proxy do Cloudflare (nuvem laranja) durante a instalação. Você pode ativar depois.

Passo 3: Ativar SSL

De volta ao painel do GW Hosting, edite o domínio recém-criado e ative:

  • SSL gratuito (Let’s Encrypt)
  • Redirecionamento automático para HTTPS

Aguarde 1-2 minutos para o certificado SSL ser instalado.

Passo 4: Executar Instalador do Mautic

Clique em Instalação Rápida de Aplicações e selecione Mautic. Na tela do instalador, preencha:

  • Nome do site: Mautic (ou o nome que preferir)
  • Diretório: Não altere
  • Versão: Selecione a versão estável disponível (atualmente Mautic 6)
  • Versão PHP: 8.3 (recomendado)
  • Database host: localhost (não altere)
  • Database name: mautic (ou nome curto de sua preferência)
  • Database user: mautic (ou repita o nome do banco)
  • Senha: Clique em gerar e SALVE esta senha

Clique em Salvar e aguarde o instalador fazer todo o trabalho. Isso pode levar 3-5 minutos.

Passo 5: Primeiro Acesso e Correção de Senha

Quando a instalação terminar, acesse a URL do seu Mautic. Você verá a tela de login. Por questões de segurança do Mautic 6, a senha padrão mautic não funciona mais. Você precisa resetá-la manualmente via banco de dados.

Vá até a seção Databases no painel do GW Hosting e clique em phpMyAdmin. Faça login com:

  • Usuário: O que você definiu no instalador
  • Senha: A que você salvou no passo 4

No phpMyAdmin, encontre a tabela users do seu banco Mautic. Você verá um usuário admin. A senha dele está criptografada e precisa ser substituída.

Abra um gerador de hash Bcrypt (pesquise “bcrypt generator” no Google). Crie uma senha forte (mínimo 8 caracteres, com letra maiúscula, número e caractere especial). Gere o hash e copie.

De volta ao phpMyAdmin, clique duas vezes no campo password do usuário admin, apague tudo e cole o hash gerado. Clique fora para salvar.

Agora você consegue fazer login com admin e a senha que você usou para gerar o hash.

Passo 6: Configurações Iniciais no Mautic

Após o primeiro login, faça estas configurações básicas:

  • Perfil: Troque o usuário de admin para seu email, defina nome e sobrenome
  • Idioma: Português do Brasil
  • Timezone: America/Sao_Paulo
  • Usuário “selles”: Delete este usuário padrão que vem criado

Passo 7: Configurar CORS (Domínios Autorizados)

Vá em Configurações > Sistema e na seção CORS, adicione TODOS os domínios e subdomínios que vão enviar dados para o Mautic. Por exemplo:

https://seusite.com
https://www.seusite.com
https://blog.seusite.com

Sem isso, formulários e scripts de rastreamento não funcionarão.

Passo 8: Limpar Cache

Vá no Gerenciador de Arquivos, navegue até /web/mautic.seusite.com/public_html/var/cache e delete as pastas prod e dev. Atualize o painel do Mautic. Agora a tradução para português deve aparecer completamente.

Verificar Tarefas Cron Criadas

As tarefas Cron são essenciais para o Mautic funcionar. O instalador já as cria automaticamente. Para verificar, vá em Tarefas no painel do GW Hosting. Você deve ver as tarefas criadas com seu usuário e domínio corretos.

Se por algum motivo elas não foram criadas, veja a seção específica sobre Cron mais abaixo neste artigo.

📊 Dados Reais

Tempo médio de instalação com GW Hosting: 8-12 minutos do zero até ter o Mautic funcionando completamente.

Testado em mais de 50 instalações desde 2024

Conhecer o GW Hosting

Vídeo: Configurando Tarefas Cron no GW Hosting

Assista este vídeo complementar sobre a configuração e entendimento das tarefas Cron:

Método 2: Instalação com WordOps (Para Quem Domina Linux)

WordOps é uma ferramenta de linha de comando que simplifica a gestão de servidores para aplicações web. Apesar do nome, funciona perfeitamente com Mautic. Este método oferece mais controle que o instalador automático, mas exige conhecimento de terminal Linux.

Quando Usar Este Método

  • Você tem experiência com linha de comando Linux
  • Quer total controle sobre configurações do servidor
  • Precisa de uma instalação personalizada
  • Já usa ou planeja usar WordOps para outros projetos

💡 Dica do Gabriel

WordOps foi minha ferramenta preferida por anos. A instalação manual dá mais trabalho, mas você aprende exatamente como tudo funciona por baixo dos panos. Se você quer se tornar realmente bom em gerenciar servidores, este é o caminho.

Vídeo: Instalação com WordOps

Resumo dos Passos Principais

A instalação com WordOps envolve:

  1. Configurar DNS no Cloudflare apontando para o IP do servidor
  2. Criar o site com WordOps usando comando específico com MySQL e PHP 7.4
  3. Baixar arquivos do Mautic do GitHub (versão 4.4.13 ou mais recente da série 4)
  4. Descompactar e ajustar permissões dos arquivos no diretório correto
  5. Configurar Nginx com arquivo personalizado para Mautic
  6. Ajustar configurações de PHP (limites de memória e timezone)
  7. Finalizar instalação via navegador inserindo dados do banco de dados
  8. Configurar tarefas Cron como usuário www-data

Para o tutorial completo e detalhado com todos os comandos, confira o curso específico sobre instalação de Mautic com WordOps disponível na Academy.

Os principais comandos que você vai usar:

wo site create mautic.seudominio.com --mysql --php74 --le --dns=dns_cf
cd /var/www/mautic.seudominio.com/htdocs/
wget [link-do-mautic]
unzip [arquivo-mautic.zip]
chown -R www-data:www-data /var/www/mautic.seudominio.com/htdocs
chmod -R g+rw /var/www/mautic.seudominio.com/htdocs

Método 3: Instalação com CloudPanel (Interface Gráfica Moderna)

CloudPanel é um painel de controle gratuito e open-source que oferece uma interface gráfica intuitiva para gerenciar servidores. É uma excelente alternativa para quem quer controle sem precisar usar terminal o tempo todo.

Vantagens do CloudPanel

  • Interface visual moderna: Tudo pode ser feito através do navegador
  • Gerenciamento de múltiplos sites: Ideal se você vai hospedar mais de um projeto
  • File Manager integrado: Upload de arquivos sem precisar de FTP
  • Gratuito e ativamente mantido: Projeto em constante evolução

Vídeo: Instalação com CloudPanel

Etapas Principais da Instalação

  1. Criar site no CloudPanel com PHP 7.4 e VHost do Mautic
  2. Configurar DNS com registros A e AAAA no Cloudflare
  3. Instalar certificado SSL via CloudPanel
  4. Ajustar VHost adicionando regra de rewrite e configurações de segurança
  5. Definir timezone correta do PHP
  6. Fazer upload dos arquivos do Mautic via File Manager
  7. Criar banco de dados e finalizar instalação via navegador
  8. Configurar tarefas Cron com usuário específico do site

CloudPanel simplifica muita coisa, mas algumas configurações específicas do Mautic precisam ser feitas manualmente. Para o tutorial passo a passo completo, veja o curso de CloudPanel com Mautic na Academy.

Um ponto importante ao usar CloudPanel com Mautic é ajustar o VHost para remover index.php das URLs e corrigir algumas configurações de segurança que conflitam com formulários e tracking do Mautic.

Método 4: Instalação com Docker (Avançado)

Docker é a escolha para quem busca isolamento completo, escalabilidade e facilidade de mover a instalação entre servidores. É o método mais “moderno” tecnicamente, mas também o que exige mais conhecimento prévio.

Por Que Usar Docker

  • Isolamento completo: O Mautic roda em containers separados do sistema
  • Facilidade de backup: Basta copiar volumes Docker
  • Portabilidade: Mova a instalação para outro servidor facilmente
  • Imagem oficial mantida: Desenvolvedor confiável mantém a imagem Docker

Vídeo: Instalação com Docker via SetupOrion

Visão Geral do Processo

A instalação via Docker com SetupOrion usa a imagem oficial do Mautic mantida por Luiz da Promov, um dos desenvolvedores mais respeitados da comunidade Mautic brasileira. O processo envolve:

  1. Configurar DNS apontando para o servidor
  2. Executar script SetupOrion e selecionar opção Mautic
  3. Fornecer informações básicas: domínio, usuário, senha do banco
  4. Aguardar instalação automática dos containers
  5. Configurar banco de dados usando credenciais da stack Docker
  6. Finalizar configurações via interface web

A grande vantagem do Docker é que todas as dependências (PHP, MySQL, Nginx) já vêm configuradas e otimizadas dentro dos containers. Para aprender a usar Docker com Mautic e outras ferramentas de marketing, confira o guia de instalação do Docker e SetupOrion.

⚠️ Atenção

Embora a versão 4 do Mautic esteja completamente estável ele infelizmente foi descontinuada e não receberá novas atualizações.
Sendo assim preciso recomendar a utilização de versões mais atuais.
Atualmente sugiro ignorar o Mautic 5 e instalar direto o Mautic o Mautic 6 usando o Instalador do Gerenciando Web Hosting ou o Setup Orion.
Comparado ao Mautic 4 a versão 6 mudou drasticamente e por isso ainda estamos trabalhando em métodos de instalação desta versão para WprdOps e CloudPanel.
Assim que tivermos o Mautic 6 consolidado nestas plataformas vamos trazer novos conteúdos sobre.

Configurando SMTP Para Enviar Emails (Essencial)

Independente do método de instalação escolhido, o Mautic não envia emails sem um servidor SMTP configurado. Esta é uma etapa obrigatória se você vai usar a plataforma para email marketing.

Por Que Preciso de SMTP Externo?

Servidores VPS normalmente têm suas portas de email bloqueadas para prevenir spam. Além disso, serviços especializados em envio garantem melhor entregabilidade e relatórios mais precisos sobre bounces e aberturas.

Melhores Opções de SMTP Para Mautic

1. Amazon SES – Melhor Custo-Benefício

Preço: $0,10 por 1.000 emails enviados (US$1 para 10.000 emails)

Vantagens: Infraestrutura robusta da AWS, alta entregabilidade, relatórios detalhados, praticamente sem limites de volume

Desvantagens: Configuração inicial mais técnica, precisa validar domínio e passar por aprovação para sair do sandbox

Ideal para: Quem já envia ou planeja enviar grandes volumes (acima de 5.000 emails/mês)

2. SendGrid – Opção Robusta

Preço: Plano gratuito com 100 emails/dia, planos pagos a partir de $19,95/mês

Vantagens: Interface intuitiva, ótima documentação, suporte técnico responsivo, integração fácil com Mautic

Desvantagens: Plano gratuito limitado, preços sobem rápido com aumento de volume

Ideal para: Pequenas empresas e quem está começando com email marketing

Para configurar o SendGrid com Mautic, veja este guia detalhado de SMTP com SendGrid.

3. SendPulse – Melhor Plano Gratuito

Preço: Plano gratuito com até 15.000 emails/mês e até 50 envios por hora.

Vantagens: Plano gratuito generoso, interface em português, fácil configuração

Ideal para: Quem está começando e tem lista pequena.

Como Configurar SMTP no Mautic

Independente do serviço escolhido, o processo é similar:

  1. Crie uma conta no serviço SMTP escolhido
  2. Gere credenciais de API ou SMTP
  3. No Mautic, vá em Configurações > Configurações de Email
  4. Selecione o tipo de transporte (pode precisar instalar plugin específico no Mautic 5/6)
  5. Insira host, porta, usuário e senha fornecidos pelo serviço
  6. Envie um email de teste para validar

💡 Dica do Gabriel

Comece sempre com o SendPulse se você tem lista pequena. Conforme sua lista crescer e você passar de 500 contatos, migre para Amazon SES. É a trajetória que faz mais sentido financeiramente.

Para integrar o Mautic com estratégias completas de marketing, veja este guia sobre estratégias de marketing de conteúdo e como usar automação para potencializar resultados.

Configurando Tarefas Cron (Crítico)

As tarefas Cron são o coração do Mautic. Sem elas configuradas corretamente, nada funciona: emails não são enviados, campanhas não executam, segmentos não atualizam. Esta é uma das partes mais importantes de toda instalação.

O Que São Tarefas Cron?

Cron é um agendador de tarefas do Linux que executa comandos automaticamente em horários específicos. No caso do Mautic, essas tarefas processam envios de email, atualizam segmentos, disparam automações e limpam dados antigos.

Estrutura de Uma Tarefa Cron do Mautic

Toda tarefa Cron do Mautic segue este padrão:

[tempo] [versão-php] [caminho-instalação]/bin/console [função]

Por exemplo:

*/5 * * * * php8.3 /home/usuario/mautic.site.com/bin/console mautic:broadcasts:send

Onde:

  • */5 * * * * = Executa a cada 5 minutos
  • php8.3 = Versão do PHP que o Mautic usa
  • /home/usuario/mautic.site.com = Caminho da instalação
  • mautic:broadcasts:send = Função específica a executar

Tarefas Cron Essenciais

1. Atualização de Segmentos

0,15,30,45 * * * * php8.3 /caminho/bin/console mautic:segments:update

Executa 4x por hora. Atualiza os segmentos baseados em regras que você criou. Por exemplo, se você tem um segmento de “contatos que abriram email nos últimos 7 dias”, esta tarefa mantém esse segmento atualizado.

2. Atualização de Campanhas

3,18,33,48 * * * * php8.3 /caminho/bin/console mautic:campaigns:update

Executa 4x por hora. Sincroniza alterações nas campanhas e prepara as próximas ações.

3. Execução de Ações de Campanha

6,21,36,51 * * * * php8.3 /caminho/bin/console mautic:campaigns:trigger

Executa 4x por hora. Esta é a tarefa que realmente FAZ as coisas acontecerem: adiciona tags, envia emails agendados, move contatos entre segmentos.

4. Envio de Emails (CRÍTICA)

12,27,42,57 * * * * php8.3 /caminho/bin/console mautic:emails:send --message-limit=300 --time-limit=180 --lock-mode=file-lock

Esta é a tarefa mais importante. Processa a fila de envio de emails.

Parâmetros importantes:

  • –message-limit=300: Envia no máximo 300 emails por execução
  • –time-limit=180: Para após 3 minutos (180 segundos)
  • –lock-mode=file-lock: Previne execuções simultâneas

Com essas configurações, seu limite é 1.200 emails por hora (300 × 4 execuções). Você pode aumentar esse limite, mas cuidado com sobrecarga do servidor.

5. Envio de Broadcasts

*/5 * * * * php8.3 /caminho/bin/console mautic:broadcasts:send

Executa a cada 5 minutos. Processa envios de emails “manuais” (broadcasts).

6. Processamento de Webhooks

*/2 * * * * php8.3 /caminho/bin/console mautic:webhooks:process

Executa a cada 2 minutos. Processa webhooks de integrações externas.

7. Importação de Dados

0 0 * * * php8.3 /caminho/bin/console mautic:import

Executa à meia-noite. Processa importações agendadas de listas.

8. Limpeza de Dados Antigos

0 4 * * * php8.3 /caminho/bin/console mautic:maintenance:cleanup --days-old=180

Executa às 4h da manhã. Remove leads anônimos e dados com mais de 180 dias.

📊 Dados Reais

Consumo de recursos das tarefas Cron: Uma instalação Mautic bem configurada com 5.000 contatos e 3 campanhas ativas consome cerca de 10-15% de CPU durante execução das Crons. O pico ocorre durante envio de emails (tarefa 4).

Medido em servidor com 2GB RAM e 1 vCore

Como Configurar as Tarefas Cron

No GW Hosting (Automático)

As tarefas já vêm criadas automaticamente pelo instalador. Você só precisa ajustar os horários das tarefas de importação e limpeza para não executarem no mesmo minuto que todos os outros clientes. Mude para um minuto aleatório entre 0-59.

Em Outros Servidores (Manual)

Acesse o terminal via SSH e execute:

sudo -u www-data crontab -e

Isso abre o editor de Cron do usuário que roda o Mautic (geralmente www-data). Cole todas as tarefas Cron ajustando:

  • Versão do PHP (php8.3 ou php8.2)
  • Caminho da instalação
  • Seu usuário do sistema

Se você configurou via CloudPanel, o usuário será específico do site criado, não www-data.

⚠️ Atenção

Mautic é uma plataforma pesada. Ele lê e escreve banco de dados constantemente. Se você tem uma lista muito grande (50.000+ contatos) ou muitas campanhas ativas, pode ser necessário um servidor dedicado. Em servidores compartilhados, mantenha um limite razoável de uso de recursos.

Se você está construindo um funil completo de marketing, integre o Mautic com outras ferramentas. Veja como instalar N8N para automação avançada, configurar Typebot para chatbots e usar Evolution API para WhatsApp.

Acessar Cursos Completos de Mautic

Comparando os 4 Métodos de Instalação

Cada método tem suas vantagens. Aqui está uma comparação direta para te ajudar a escolher:

Critério GW Hosting WordOps CloudPanel Docker
Dificuldade Fácil Difícil Média Difícil
Tempo 10-15 min 45-60 min 30-45 min 20-30 min
Controle Médio Total Alto Total
Cron Automático Sim Não Não Não
Requer SSH Não Sim Parcial Sim
Melhor Para Iniciantes Desenvolvedores Intermediários DevOps
Suporte Mautic 6 Sim Em Breve Em breve Sim

Perguntas Frequentes

Posso instalar o Mautic em hospedagem compartilhada?

Tecnicamente sim, mas não recomendo. Mautic consome muitos recursos e hospedagens compartilhadas têm limites rígidos. Você terá problemas de performance e pode ter a conta suspensa por uso excessivo. VPS é o mínimo aceitável.

Quanto de RAM o Mautic precisa?

Mínimo 2GB para instalações pequenas (até 5.000 contatos). Ideal 4GB para uso confortável. Com 8GB você roda múltiplas campanhas sem preocupação. Acima de 20.000 contatos, considere 8GB+ de RAM.

Posso usar Gmail ou Outlook como SMTP?

Pode, mas não deve. Esses serviços têm limites muito baixos (100-500 emails/dia) e podem bloquear sua conta se detectarem envio em massa. Use sempre serviços especializados como os mencionados neste artigo.

Preciso saber programar para usar Mautic?

Não. A interface do Mautic é visual e intuitiva. Porém, para instalar e configurar o servidor, conhecimento técnico ajuda bastante. Se você não tem, use o método do GW Hosting que simplifica tudo.

Qual a diferença entre Mautic 4, 5 e 6?

Mautic 4 é a versão mais estável e testada. Mautic 5 trouxe mudanças visuais mas teve problemas de estabilidade. Mautic 6 é a mais recente, corrige bugs da versão 5, mas ainda está em maturação. Para produção, hoje recomendo Mautic 4.4.13 ou Mautic 6 se usar instalador automático.

Como faço backup do Mautic?

Você precisa fazer backup de duas coisas: (1) Banco de dados MySQL (use phpMyAdmin ou mysqldump) e (2) Pasta de arquivos do Mautic. Faça isso semanalmente no mínimo. Se usar Docker, basta fazer backup dos volumes.

Posso migrar o Mautic de um servidor para outro?

Sim. Exporte o banco de dados, copie todos os arquivos para o novo servidor, importe o banco e atualize as configurações em config/local.php. Se usar Docker, é ainda mais simples: copie as stacks e volumes.

O Mautic consome muita banda de internet?

Depende do volume de envios e rastreamento. Uma campanha de 10.000 emails consome aproximadamente 50-100MB de banda. O rastreamento de páginas é leve. Com 1TB de banda mensal você envia tranquilamente 100.000+ emails.

Próximos Passos Após a Instalação

Agora que seu Mautic está instalado e funcionando, é hora de colocar em prática. Aqui estão os próximos passos que recomendo:

  1. Configure seu primeiro formulário de captura e instale em uma página de vendas profissional
  2. Crie sua primeira campanha de email marketing seguindo estratégias comprovadas de email marketing
  3. Configure rastreamento de páginas para entender o comportamento dos visitantes
  4. Integre com WhatsApp usando Evolution API para automação multi-canal
  5. Conecte com chatbot instalando Typebot para qualificação de leads

O Mautic é uma ferramenta poderosa, mas só funciona se você usar. Comece simples: um formulário, uma lista, uma campanha. Depois expanda para automações mais complexas conforme ganha experiência.

💡 Dica do Gabriel

Depois de instalar dezenas de Mautic ao longo dos anos, aprendi que a instalação perfeita não existe. Sempre vai ter algum ajuste a fazer, alguma configuração para otimizar. O importante é começar, mesmo que não seja perfeito. Você aprende 10x mais usando do que estudando teoria.

Acessar Treinamentos Completos

Autor

Gabriel Wohlfart é CEO do Gerenciando Web e especialista em WordPress, Servidores Cloud, Mautic, SEO e Automação.
Mais de 3.500 alunos já passaram pelos seus cursos. Saiba mais.