Base de Conhecimento

Mautic na VPS: automação de marketing própria

  • mautic na vps, mautic, automação de marketing, docker, vps
  • Usuários acharam útil: 0

Aprenda a instalar o Mautic no seu servidor com Docker Compose, trocar as senhas do banco, criar o administrador, configurar o SMTP, os cron jobs e o HTTPS.

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

Arte da Eleven Host: janela de terminal com o título: Mautic na VPS: automação de marketing própria

Capa da Redação Eleven Host para o tutorial: Mautic na VPS: automação de marketing própria Arte: Eleven Host

Mautic na VPS é a automação de marketing que você hospeda por conta própria: contatos, segmentos e campanhas ficam no seu servidor. A imagem oficial roda com Docker Compose, e os e-mails saem por um serviço de SMTP que você configura.

O que é o Mautic e qual é a licença

O Mautic é uma plataforma de automação de marketing: você cadastra contatos, separa em segmentos e monta campanhas que executam ações e enviam e-mails. O projeto mantém uma imagem oficial no Docker, o docker-mautic, para as versões 5 e posteriores.

O Mautic só envia e-mail depois que você configura um transporte de e-mail, e as campanhas só andam se as tarefas agendadas (cron jobs) estiverem rodando.

Segundo o arquivo de licença do projeto, o Mautic é distribuído sob a GNU General Public License, versão 3, ou, a seu critério, uma versão posterior. Em caso de dúvida sobre uso comercial, consulte um profissional.

Antes de começar

Se você está conhecendo servidores agora, leia primeiro o guia de iniciantes sobre servidor VPS. Para este tutorial, você precisa de:

  • Docker com o Compose v2 instalado na VPS. O README do docker-mautic pede o comando docker compose.
  • Um domínio ou subdomínio, como mautic.exemplo.com, apontado para o IP da VPS, porque a documentação do Mautic recomenda acessar o painel por HTTPS.
  • Um serviço de SMTP para os envios. Veja a seção sobre e-mail mais abaixo.

A documentação não informa quanto de memória, processador ou disco o servidor precisa. O que ela informa é que o PHP deve ter max_execution_time de pelo menos 240 segundos, e que o instalador avisa quando o memory_limit do PHP está abaixo de 512M. Comece pequeno, acompanhe o consumo e ajuste conforme o tamanho da sua base de contatos.

Na versão 7.2.2, publicada em 26 de outubro segundo a página de releases do GitHub, o Mautic 7 pede MySQL 8.4 ou MariaDB 10.11.0, no mínimo. Para as versões anteriores à 7, o mínimo é MySQL 5.7 ou MariaDB 10.2. O PHP aceito na versão 7.0 vai do 8.2 ao 8.5.

Está escolhendo uma VPS? VPS a partir de R$ 17,00/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver os planos de VPS

Os arquivos do exemplo oficial

O repositório docker-mautic, no GitHub, traz exemplos na pasta examples. O mais simples se chama basic e usa a imagem com Apache. Ele tem três arquivos: docker-compose.yml, .env e .mautic_env. Copie os três para uma pasta na VPS.

O Compose do exemplo sobe quatro serviços:

  • db: o banco MySQL, com os dados no volume mysql-data.
  • mautic_web: o painel e o site do Mautic, publicado na porta 8080 do servidor.
  • mautic_cron: o contêiner que roda as tarefas agendadas.
  • mautic_worker: o contêiner que processa a fila de e-mails e de acessos.

O próprio README do projeto avisa que os exemplos não devem ir para produção sem revisão. Por isso, as três mudanças abaixo são o mínimo antes de subir.

1. Troque as senhas do banco

O arquivo .env do exemplo vem com senhas públicas, que estão visíveis no repositório:

MYSQL_PASSWORD=mautic_db_pwd

MYSQL_ROOT_PASSWORD=changeme

Troque os dois valores por senhas fortes e diferentes entre si, e guarde-as em um lugar seguro. Faça isso antes da primeira subida, porque o banco é criado com esses valores. O restante do arquivo define o banco como mautic_db e o usuário como mautic_db_user; você pode mantê-los.

2. Fixe a versão da imagem

O exemplo usa mautic/mautic:latest nos três serviços do Mautic. As etiquetas seguem o formato versão e variante, como 7.2.2-apache ou 7-apache. Fixar a etiqueta evita que uma subida futura traga uma versão diferente da que você testou. Troque a etiqueta nos serviços mautic_web, mautic_cron e mautic_worker:

image: mautic/mautic:7.2.2-apache

O README do projeto recomenda a variante Apache em vez da FPM por enquanto. Ele ainda cita versões mais antigas na tabela de builds, então prefira conferir as etiquetas no Docker Hub.

3. Confira o banco de dados

O serviço db do exemplo usa a imagem mysql:lts. Como o Mautic 7 exige MySQL 8.4 ou superior, confira no Docker Hub a qual versão essa etiqueta aponta no dia da sua instalação. Não troque a imagem por uma do MySQL 5.7 se for instalar o Mautic 7.

Subir o Mautic

Na pasta com os três arquivos, suba os serviços em segundo plano:

docker compose up -d

O serviço do painel só é considerado pronto depois que o banco responde, e os outros dois esperam por ele. Acompanhe com docker compose ps até os contêineres aparecerem em execução.

O arquivo publica o painel como 8080:80, o que deixa a porta 8080 aberta nas interfaces do servidor. Para um teste rápido, abra http://203.0.113.10:8080 no navegador (um IP de exemplo; use o da sua VPS). Se for colocar um proxy com HTTPS na frente, veja a seção sobre HTTPS, que fecha essa porta para fora.

Se preferir acompanhar os contêineres pelo navegador, veja o guia Portainer na VPS: como gerenciar o Docker pelo navegador.

Primeiro acesso e administrador

Existem dois caminhos para criar o administrador. No navegador, a documentação descreve um instalador em etapas:

  • Uma checagem do ambiente: itens em vermelho precisam ser corrigidos, e os laranja são recomendações.
  • Os dados do banco. Em uma instalação nova, desligue a opção de fazer backup das tabelas existentes.
  • A janela de usuário administrativo, onde você cria o login e a senha.

Depois disso, entre com as credenciais que acabou de criar. Faça esse passo logo depois de subir o Mautic.

O outro caminho é pelo console. O README mostra o comando que começa assim, e a URL do site, o e-mail e a senha do administrador entram como parâmetros em seguida:

docker compose exec --user www-data --workdir /var/www/html mautic_web php ./bin/console mautic:install

Consulte o README do docker-mautic, no GitHub, para a linha completa com os parâmetros --admin_email e --admin_password.

Os cron jobs que mantêm as campanhas andando

A documentação do Mautic explica que ele precisa de algumas tarefas agendadas para a manutenção, como atualizar contatos e campanhas, executar as ações das campanhas e enviar e-mails. As obrigatórias são estas:

php /path/to/mautic/bin/console mautic:segments:update

php /path/to/mautic/bin/console mautic:campaigns:update

php /path/to/mautic/bin/console mautic:campaigns:trigger

Para enviar as mensagens de campanha reagendadas por regras de frequência, existe também o comando mautic:messages:send. Se você usa campos personalizados, há mautic:custom-field:create-column e mautic:custom-field:delete-column. Já o mautic:campaigns:resume-stuck serve para rodar manualmente, uma única vez, quando você investiga uma campanha travada.

A documentação sugere escalonar os minutos para os comandos não rodarem ao mesmo tempo:

0,15,30,45 mautic:segments:update

5,20,35,50 mautic:campaigns:update

10,25,40,55 mautic:campaigns:trigger

O caminho /path/to/mautic/ vale para uma instalação sem Docker. No exemplo oficial, o contêiner mautic_cron já cuida dessas tarefas, então não é preciso criar um crontab no servidor. Se quiser mudar a agenda, o Compose traz uma linha comentada que monta uma pasta ./cron no caminho /opt/mautic/cron; tire o comentário dela para personalizar.

Configurar o envio de e-mail

Sem um transporte de e-mail configurado, o Mautic não envia mensagens. Use um serviço de SMTP e consulte a documentação dele para obter servidor, porta, usuário e senha.

Na janela de configuração de e-mail do instalador, ou depois nas configurações do painel, informe os dados do provedor, o nome do remetente e o endereço de remetente. O provedor precisa ter autorizado esse endereço. Se o seu serviço não está na lista, escolha a opção de outro servidor SMTP e preencha servidor, porta, criptografia e autenticação.

A documentação diz ainda que o envio por API do provedor é mais rápido que o SMTP. Faça um envio de teste para você mesmo antes de disparar uma campanha. O Mautic não garante que a mensagem chegue à caixa de entrada; isso depende do serviço de envio.

No exemplo oficial, a fila de e-mails usa o banco (doctrine://default) e é consumida pelo mautic_worker. Esta é a linha que liga as duas pontas, no arquivo .mautic_env:

MAUTIC_MESSENGER_DSN_EMAIL="doctrine://default"

O número de processos do worker para e-mail tem padrão 2, ajustável pela variável DOCKER_MAUTIC_WORKERS_CONSUME_EMAIL.

HTTPS com um proxy reverso

O README e o exemplo basic não trazem proxy nem HTTPS. A documentação só recomenda acessar por HTTPS. Uma forma comum é colocar um proxy reverso na frente da porta 8080, que cuida do certificado e encaminha o acesso ao Mautic. Este é um caminho de uso comum, e não uma instrução da documentação do projeto.

Para que o painel só receba acesso pelo proxy, troque a linha da porta no serviço mautic_web:

- 127.0.0.1:8080:80

Assim, a porta 8080 fica visível só para o próprio servidor. Depois, rode docker compose up -d de novo.

O guia Nginx Proxy Manager: vários sites numa VPS só mostra um painel para cuidar do certificado. Se preferir um servidor web com certificado automático, veja o Caddy na VPS.

Atualização e backup

O README do docker-mautic não tem uma seção de atualização, e a documentação do Docker do projeto não traz um procedimento de backup. Por isso, recomendamos este roteiro simples, que é um conselho nosso, e não um método oficial:

  1. Faça uma cópia do banco e da pasta mautic (com config, logs e media) e guarde fora da VPS.
  2. Leia as notas da release da versão nova. Ao passar de uma versão maior para outra, como da 6 para a 7, isso pesa ainda mais.
  3. Troque a etiqueta da imagem nos três serviços do Mautic.
  4. Rode docker compose pull e depois docker compose up -d.

O README explica que a configuração fica na pasta config (arquivos local.php e parameters_local.php), e que os dados do banco e da fila não ficam dentro da imagem. É por isso que o banco precisa do volume mysql-data e do backup.

Checklist depois de instalar

  • Troquei MYSQL_PASSWORD e MYSQL_ROOT_PASSWORD antes da primeira subida.
  • Fixei a etiqueta da imagem, como 7.2.2-apache.
  • Conferi que o banco atende ao mínimo da versão do Mautic.
  • Criei o administrador logo depois de subir.
  • Configurei o serviço de SMTP e enviei um teste para mim.
  • Confirmei que o mautic_cron e o mautic_worker estão em execução.
  • Publiquei a porta como 127.0.0.1:8080:80 e coloquei um proxy com HTTPS na frente.
  • Fiz o backup do banco e da pasta mautic.

Um domínio para as suas campanhas

Para acessar o painel por HTTPS, como a documentação do Mautic recomenda, você precisa de um domínio ou subdomínio. Se ainda não tem um, você pode registrar um na Eleven Host.

Ainda não tem um domínio para as suas campanhas? Registre o seu na Eleven Host. Registrar domínio

Perguntas frequentes

O Mautic envia e-mail sozinho?

Não. Ele depende de um transporte de e-mail configurado, como um serviço de SMTP, e de um worker ou do cron para processar os envios.

Qual é a licença do Mautic?

Segundo o arquivo de licença do projeto, GPL versão 3 ou, a seu critério, posterior. Em caso de dúvida sobre uso comercial, consulte um profissional.

Em qual porta o Mautic abre no exemplo oficial?

Na 8080 do servidor, ligada à porta 80 do contêiner. Para acesso externo com HTTPS, coloque um proxy reverso na frente.

Preciso criar o crontab no servidor?

No exemplo oficial com Docker, não. O contêiner mautic_cron roda as tarefas agendadas. O crontab com /path/to/mautic/ da documentação é para instalação sem Docker.

Posso usar o exemplo oficial em produção do jeito que está?

Não. O README avisa que os exemplos precisam de revisão antes de ir para produção. Troque as senhas, fixe a versão da imagem e coloque HTTPS na frente.

Esta resposta lhe foi útil?

Artigos Relacionados