Tutoriais de VPS
Mautic na VPS: Docker, SMTP, campanhas e backups
Implante Mautic com Docker, banco suportado e Caddy. Configure papéis web, cron e worker, campanhas, SMTP, consentimento e rastreamento; verifique backups coerentes, recuperação e atualizações.

O Mautic reúne contatos, segmentos, campanhas, formulários e rastreamento em uma plataforma própria de marketing. Você controla a implantação e as regras, mas também cuida de banco, tarefas agendadas, reputação de e-mail e recuperação. Compare custos de VPS, envio e manutenção com os de um serviço gerenciado.
Este guia usa Ubuntu 24.04, Docker Compose, banco compatível com MySQL e Caddy. As imagens oficiais a partir do Mautic 5 separam web, cron e workers. Escolha uma versão suportada e seus exemplos completos; uma receita antiga de contêiner único não representa essa arquitetura.
| Recurso | Teste | Referência para equipe pequena |
|---|---|---|
| CPU | 2 vCPU | 4 vCPU ou mais |
| RAM | 2 GB | 4 GB ou mais |
| Disco | 30 GB SSD | 60 GB SSD ou mais |
| Sistema | Ubuntu 22.04/24.04 | Ubuntu 24.04 LTS |
| Domínio | mautic.example.com | Subdomínio de marketing |
São orçamentos iniciais, sem garantia de capacidade. Importações, campanhas, relatórios e workers consomem mais que a interface web. Confira free -h, df -h e docker stats; veja dimensionamento. Configure A/AAAA funcionais, mantenha o banco privado e abra apenas administração necessária e 80/443 públicos no firewall do provedor.
sudo apt update
sudo apt install -y ca-certificates curl openssl
curl -fsSL https://get.docker.com | sudo sh
sudo usermod -aG docker "$USER"
newgrp docker
sudo mkdir -p /opt/mautic
sudo chown -R "$USER":"$USER" /opt/mautic
cd /opt/mautic
Revise o instalador executado como root ou use pacotes suportados. O grupo Docker concede acesso poderoso ao anfitrião.
openssl rand -hex 32
openssl rand -base64 32
Gere credenciais independentes e os segredos exigidos pela versão. Guarde valores reais em arquivos protegidos, fora de repositórios públicos.
O esboço antigo mostra banco e porta web privada. Não o use sem alterações nas imagens atuais: MAUTIC_DB_NAME e MAUTIC_RUN_CRON_JOBS não substituem a variável documentada nem os papéis atuais. Montar todo /var/www/html também pode ocultar ou preservar código entre atualizações.
services:
db:
image: mariadb:10.11
restart: unless-stopped
command: --character-set-server=utf8mb4 --collation-server=utf8mb4_unicode_ci
environment:
MYSQL_DATABASE: mautic
MYSQL_USER: mautic
MYSQL_PASSWORD: change-a-long-password
MYSQL_ROOT_PASSWORD: change-a-root-password
volumes:
- db_data:/var/lib/mysql
healthcheck:
test: ["CMD", "healthcheck.sh", "--connect", "--innodb_initialized"]
interval: 10s
timeout: 5s
retries: 15
mautic:
image: mautic/mautic:latest
restart: unless-stopped
depends_on:
db:
condition: service_healthy
environment:
MAUTIC_DB_HOST: db
MAUTIC_DB_NAME: mautic
MAUTIC_DB_USER: mautic
MAUTIC_DB_PASSWORD: change-a-long-password
MAUTIC_RUN_CRON_JOBS: "false"
ports:
- "127.0.0.1:8080:80"
volumes:
- mautic_data:/var/www/html
volumes:
db_data:
mautic_data:
Comece pelo exemplo básico oficial:
- Baixe o exemplo com .env e .mautic_env em um diretório próprio e registre a revisão.
- No .env, configure MYSQL_DATABASE, MYSQL_USER, MYSQL_PASSWORD e MYSQL_ROOT_PASSWORD. Escolha um banco suportado pela versão; o exemplo atual usa MySQL, sem garantir qualquer MariaDB.
- No .mautic_env, defina MAUTIC_DB_HOST=db, MAUTIC_DB_DATABASE e MAUTIC_DB_USER/MAUTIC_DB_PASSWORD coerentes. Os três serviços compartilham configuração e credenciais.
- Fixe todos os serviços Mautic na mesma tag Apache suportada. A nomenclatura documentada inclui 6.0.6-apache; verifique a versão escolhida. Os mantenedores desaconselham o exemplo FPM/Nginx sem conhecimento da configuração.
- Mantenha mautic_web, mautic_cron e mautic_worker. Os dois últimos usam DOCKER_MAUTIC_ROLE=mautic_cron e mautic_worker. Defina DOCKER_MAUTIC_LOAD_TEST_DATA=false.
- Publique a web em 127.0.0.1:8080:80. Preserve config, var/logs e docroot/media files/images para todos os papéis, com dono e escrita corretos. Não publique o banco.
Os comandos antigos pressupõem um serviço mautic; adapte o nome ao modelo:
docker compose config
docker compose pull
docker compose up -d
docker compose ps
docker compose logs --tail=150 mautic
No diretório do modelo atual:
docker compose config --quiet
docker compose pull
docker compose up -d
docker compose ps
docker compose logs --tail=100 mautic_web mautic_cron mautic_worker
A web funcionar não comprova cron ou consumo das filas. A configuração expandida pode mostrar senhas; proteja essa saída.
ssh -L 8080:127.0.0.1:8080 root@SERVER_IP
Abra http://127.0.0.1:8080 no computador de administração pelo túnel. Nessa rede, o host do banco é db, não localhost. Teste as URLs públicas no hostname HTTPS final.
- Configure identidade, fuso horário e idioma.
- Use senha administrativa forte e MFA quando a edição suportar.
- Configure remetente e nome exibido.
- Defina URLs de formulários, páginas e rastreamento.
- Crie contato e campanha de teste.
- Verifique aberturas, cliques, descadastro e erros com destinatários de teste; proteções de privacidade podem tornar aberturas uma métrica pouco confiável.
sudo apt install -y caddy
sudo nano /etc/caddy/Caddyfile
mautic.example.com {
encode gzip zstd
reverse_proxy 127.0.0.1:8080
header {
Strict-Transport-Security "max-age=31536000; includeSubDomains"
X-Content-Type-Options "nosniff"
X-Frame-Options "SAMEORIGIN"
}
}
sudo caddy validate --config /etc/caddy/Caddyfile
sudo systemctl reload caddy
curl -I https://mautic.example.com
Use um único gateway em 80/443, encaminhando para 8080 privada. Ajuste URL pública e proxies confiáveis. HSTS/includeSubDomains exige HTTPS nos nomes afetados. Veja Caddy.
Escolha um provedor que permita explicitamente suas campanhas; um relay transacional não aceita necessariamente marketing. Evite senhas comuns de contas pessoais.
- Use subdomínio de envio, como mail.example.com.
- Configure SPF, DKIM e DMARC conforme o provedor.
- Confira PTR do IP SMTP que realmente envia; em relay, normalmente o provedor gerencia esse DNS reverso, não a VPS.
- Inclua descadastro claro e funcional.
- Comece com lotes pequenos e consentimento, respeitando limites de envio.
- Monitore devoluções definitivas, reclamações e descadastros; suprima endereços inválidos ou removidos da lista.
Envie um teste direto e outro pela campanha. Examine autenticação, registros, devoluções e spam antes de aumentar a concorrência.
Nas imagens atuais, comece pelos papéis oficiais cron e worker. Se optar por comandos no anfitrião, examine a CLI instalada e execute cada tarefa primeiro com o usuário da aplicação.
crontab -e
Esta agenda antiga mostra periodicidade, mas não forma um fluxo atual completo:
*/5 * * * * cd /opt/mautic && docker compose exec -T mautic php bin/console mautic:campaigns:trigger --no-interaction >/dev/null 2>&1
*/10 * * * * cd /opt/mautic && docker compose exec -T mautic php bin/console mautic:segments:update --no-interaction >/dev/null 2>&1
*/5 * * * * cd /opt/mautic && docker compose exec -T mautic php bin/console mautic:emails:send --no-interaction >/dev/null 2>&1
Atualizar segmentos, atualizar participação nas campanhas e disparar eventos são etapas diferentes. Confira requisitos e ordem de mautic:segments:update, mautic:campaigns:update e mautic:campaigns:trigger. Comandos antigos de e-mail podem diferir dos workers Messenger. Use list e os arquivos cron da versão; quando necessário, execute como www-data em /var/www/html.
- Escolha um único responsável: papel cron ou tarefas próprias do anfitrião.
- Evite sobreposição com travas e limites de processamento.
- Separe tarefas dependentes e meça duração antes de reduzir intervalos.
- Preserve logs protegidos e alertas de erro; não descarte toda a saída.
- Use workers para transportes assíncronos e monitore acúmulo das filas separadamente.
- Explique finalidade, cookies e retenção.
- Exija apenas campos necessários.
- Registre consentimento de marketing separado de avisos de serviço.
- Prepare processo de acesso, exportação e exclusão de dados.
- Não coloque API keys ou credenciais SMTP/banco no navegador.
- Use HTTPS e confira CORS e cabeçalhos.
Aplique as regras pertinentes às pessoas cujos dados você trata, incluindo exigências regionais de consentimento e rastreamento. No Cloudflare, evite cache para sessões, formulários e respostas personalizadas; não reutilize a resposta de um contato para outro.
O exemplo antigo pressupõe cliente MariaDB e volume específicos:
mkdir -p /opt/mautic/backups
docker compose exec -T db mysqldump -umautic -p"YOUR_DB_PASSWORD" mautic | gzip > /opt/mautic/backups/mautic-$(date +%F).sql.gz
docker run --rm -v mautic_mautic_data:/data -v /opt/mautic/backups:/backup alpine sh -c 'tar czf /backup/mautic-data-$(date +%F).tgz -C /data .'
cp .env docker-compose.yml /opt/mautic/backups/
Use o cliente suportado pelo banco e credenciais protegidas. Ative pipefail e verifique a exportação. Inspecione montagens reais, sem adivinhar prefixos Compose. No modelo atual, salve banco, config, media, .env, .mautic_env, Compose e versões; logs também ajudam. Interrompa escritas e workers para obter um ponto coerente e fazer cópias físicas.
Guarde cópias externas criptografadas. Restaure a mesma versão em máquina limpa e teste administrador, contatos, formulários, campanhas, modelos e descadastro. Desative envios/rastreamento ou use destinatários de teste para não repetir campanhas. Veja recuperação testada.
docker compose config > /opt/mautic/backups/compose-$(date +%F).yaml
docker compose pull
docker compose up -d
docker compose ps
docker compose logs --tail=200 mautic
Fixe versões antiga/nova, faça backup e teste migrações. Não siga latest automaticamente. Um banco migrado pode exigir restaurar o backup anterior para reverter; trocar somente a imagem não basta.
docker compose ps
docker compose logs --tail=200 mautic
sudo journalctl -u caddy -n 100 --no-pager
ss -lntp | grep -E ':8080|:80|:443'
No modelo atual, examine mautic_web. Confira 8080 privada, upstream, URL final, proxy confiável e cookies HTTPS.
Execute o comando manualmente e confira saída, responsável cron, acesso Docker, usuário, atualização de campanhas, travas e filas. Reduzir o intervalo não conserta uma tarefa com erro.
Procure schedulers duplicados, consumidores com configuração diferente, limites do provedor, devoluções e reclamações. Exporte dados de auditoria antes de excluir contatos e preserve o histórico de descadastro.
- Domínio, HTTPS, login e formulários funcionando.
- SMTP, SPF, DKIM, DMARC e PTR do remetente verificados.
- Segmentos, campanhas e filas funcionando com monitoramento.
- Banco e portas internas privados; administração com acesso controlado.
- Configuração, banco e media com cópia externa criptografada.
- Restauração segura concluída em instância separada.
- Versões, migrações e reversão documentadas.
Comece com público pequeno e valide o fluxo completo, do consentimento ao descadastro, antes de ampliar campanhas.