Mautic na VPS: automação de marketing própria
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

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:
- Faça uma cópia do banco e da pasta
mautic(comconfig,logsemedia) e guarde fora da VPS. - 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.
- Troque a etiqueta da imagem nos três serviços do Mautic.
- Rode
docker compose pulle depoisdocker 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_PASSWORDeMYSQL_ROOT_PASSWORDantes 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_crone omautic_workerestão em execução. - Publiquei a porta como
127.0.0.1:8080:80e 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.