Como Instalar Mautic: 4 Métodos (VPS, Docker, CloudPanel, Automático)

Instalar o Mautic é mais simples do que parece, e a instalação em si é a parte fácil. O que separa um Mautic que funciona de um que fica mudo são os três ajustes que vêm depois: SMTP, cron e HTTPS. Pular qualquer um deles é a causa nº 1 de "instalei e não envia e-mail".

O Mautic 5 tem um caminho para cada perfil: do VPS Linux, que dá controle total, ao Docker e aos painéis com poucos cliques. Este guia cobre os quatro métodos e, principalmente, a configuração pós-instalação que os tutoriais costumam tratar como detalhe. O fluxo do começo ao fim é este:

Requisitos Técnicos para Instalar Mautic

Servidor e Software

Estes são os requisitos mínimos recomendados para rodar o Mautic 5 em produção:

• PHP: 8.1+ (8.2 ou 8.3 recomendado em 2026)
• MySQL/MariaDB: MySQL 8.0+ ou uma versão recente do MariaDB (o Mautic não suporta PostgreSQL)
• Memória RAM: 2GB mínimo, 4GB+ para 100K+ contatos
• Espaço em Disco: 10GB para começar, 100GB+ para crescimento
• Extensões PHP: cURL, JSON, PDO MySQL, GD, Intl, OpenSSL, mbstring

Dica: use PHP 8.3 com o OPcache habilitado. As versões mais novas do PHP, somadas ao cache de opcode, deixam o Mautic sensivelmente mais rápido do que em PHP antigo.

Método 1: Instalação em VPS Linux (Ubuntu 22.04)

Passo 1: Acessar o VPS e Atualizar o Sistema

A instalação em VPS começa pela preparação do ambiente Linux:

ssh root@seu_ip_vps
sudo apt update && sudo apt upgrade -y
sudo apt install -y php8.3 php8.3-{cli,common,mysql,zip,gd,mbstring,curl,xml,fpm,intl} mysql-server nginx

Passo 2: Criar Banco de Dados

Configure o MySQL para receber a instalação do Mautic:

sudo mysql
CREATE DATABASE mautic CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'mautic_user'@'localhost' IDENTIFIED BY 'sua_senha_forte_aqui';
GRANT ALL PRIVILEGES ON mautic.* TO 'mautic_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Passo 3: Baixar e Extrair Mautic

Obtenha a versão mais recente do Mautic 5:

cd /var/www
# confira a versão estável mais recente em github.com/mautic/mautic/releases
sudo wget https://github.com/mautic/mautic/releases/download/5.0.0/mautic-5.0.0.zip
sudo unzip mautic-5.0.0.zip -d mautic
sudo chown -R www-data:www-data mautic
sudo chmod -R 755 mautic

Passo 4: Configurar Nginx

Crie um arquivo de configuração para o site do Mautic:

sudo nano /etc/nginx/sites-available/mautic

server {
    listen 80;
    server_name seu_dominio.com www.seu_dominio.com;
    root /var/www/mautic;
    index index.php;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        fastcgi_pass unix:/var/run/php/php8.3-fpm.sock;
        fastcgi_index index.php;
        include fastcgi_params;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    }

    location ~ /\.ht {
        deny all;
    }
}

sudo ln -s /etc/nginx/sites-available/mautic /etc/nginx/sites-enabled/
sudo systemctl reload nginx

Passo 5: Acessar o Instalador Web

Abra seu navegador e acesse:

http://seu_dominio.com/installer

Siga o wizard de instalação do Mautic. Na seção de banco de dados, use:

• Host: localhost
• Usuário: mautic_user
• Senha: sua_senha_forte_aqui
• Database: mautic

Método 2: Instalação com Docker (Mais Rápido)

Por Que Docker?

A instalação com Docker serve bem para testar ou para quem não quer lidar com dependências de PHP:

• Configuração isolada e reprodutível
• Sem conflitos com outras aplicações
• Portável entre servidores
• Atualizações fáceis

Instalando Docker e Docker Compose

sudo apt update
sudo apt install -y docker.io docker-compose-plugin
sudo usermod -aG docker $USER
newgrp docker

Arquivo docker-compose.yml para Mautic

services:
  mysql:
    image: mysql:8.0
    environment:
      MYSQL_ROOT_PASSWORD: rootpassword
      MYSQL_DATABASE: mautic
      MYSQL_USER: mautic_user
      MYSQL_PASSWORD: mauticpass123
    volumes:
      - mysql_data:/var/lib/mysql
    ports:
      - "3306:3306"

  mautic:
    image: mautic/mautic:latest
    environment:
      MAUTIC_DB_HOST: mysql
      MAUTIC_DB_USER: mautic_user
      MAUTIC_DB_PASSWORD: mauticpass123
      MAUTIC_DB_NAME: mautic
    volumes:
      - mautic_data:/var/www/html
    ports:
      - "80:80"
    depends_on:
      - mysql

volumes:
  mysql_data:
  mautic_data:

Execute:

docker compose up -d
docker compose logs -f mautic

Acesse http://localhost ou seu IP do servidor. O Mautic estará disponível em minutos.

Método 3: CloudPanel (Instalação Simplificada)

O CloudPanel é um painel de controle que instala o Mautic com poucos cliques. Bom para quem está começando:

Passos Rápidos

1. Contrate um VPS compatível com CloudPanel (Hetzner, Linode, DigitalOcean)
2. Instale CloudPanel via SSH: curl -sSL https://installer.cloudpanel.io/ce | sudo bash
3. Acesse https://seu_ip:8443 e crie uma conta
4. Vá a "Application" → "New Application" → busque por "Mautic"
5. Escolha o domínio e clique "Add"
6. o CloudPanel cuida de toda a instalação automaticamente

Benefício: o CloudPanel cuida do SSL via Let's Encrypt, de backups e de atualizações. A edição Community é gratuita, e o custo é apenas o do VPS. Serve bem para quem prefere não usar linha de comando.

Método 4: One-Click Installers (Mais Automático)

Alguns provedores incluem o Mautic no catálogo de auto-instaladores (como o Softaculous e o Installatron). Quando disponível, basta:

1. Fazer login no painel de controle do hosting
2. Procurar por "Aplicativos" ou "Apps Marketplace"
3. Buscar "Mautic" e clicar "Instalar"
4. Escolher domínio e configurações básicas
5. Pronto! Em 5 minutos está funcionando

Configuração Pós-Instalação do Mautic

Configurar SMTP para Envio de Emails

Sem SMTP configurado, o Mautic não envia e-mail nenhum. Um serviço de envio transacional (Amazon SES, Brevo, Mailgun) resolve, e todos cobram por volume, a valores baixos por milhares de e-mails. Usando o Amazon SES, por exemplo:

1. Acesse a Dashboard do Mautic
2. Vá para Configurações (ícone de engrenagem) → Email Settings
3. Em "SMTP Server", escolha "Amazon SES"
4. Insira suas credenciais AWS:
   • Access Key
   • Secret Key
   • Region: us-east-1 (ou sua região)
5. Clique "Save"

Importante: Valide seus emails no SES. De início, você só pode enviar para emails que você mesmo validou. Solicite aumento de limite após alguns dias.

Configurar Cron Jobs

O Mautic precisa de cron jobs para funcionar corretamente. Adicione à crontab do servidor:

crontab -e

# Agendar campanhas
*/5 * * * * php /var/www/mautic/bin/console mautic:campaigns:process -vvv > /var/log/mautic-campaigns.log 2>&1

# Processar segmentos
0 * * * * php /var/www/mautic/bin/console mautic:segments:update -vvv > /var/log/mautic-segments.log 2>&1

# Processar webhooks
*/5 * * * * php /var/www/mautic/bin/console mautic:webhooks:process -vvv > /var/log/mautic-webhooks.log 2>&1

# Limpeza de logs
0 2 * * * php /var/www/mautic/bin/console mautic:maintenance:cleanup -vvv > /var/log/mautic-cleanup.log 2>&1

Habilitar HTTPS com Let’s Encrypt

A sua instalação deve rodar sob HTTPS antes de ir para produção. Com o Nginx:

sudo apt install -y certbot python3-certbot-nginx
sudo certbot certonly --nginx -d seu_dominio.com

Troubleshooting: Problemas Comuns na Instalação

Erro 500 após instalação

Verifique permissões e logs:

sudo chown -R www-data:www-data /var/www/mautic
tail -f /var/log/nginx/error.log

Banco de dados não conecta

Valide credenciais e que MySQL está rodando:

sudo systemctl status mysql
mysql -u mautic_user -p mautic

Emails não são enviados

Verifique SMTP configurado corretamente e teste:

php /var/www/mautic/bin/console mautic:email:send --help

Melhorando a Performance do Mautic

Com o Mautic já no ar, dá para otimizar a plataforma para suportar mais contatos:

• Redis Cache: Adicione cache em memória para 2-3x velocidade
• MySQL Tuning: Aumente max_connections e buffer_pool_size
• PHP-FPM: Aumente pm.max_children para mais concorrência
• CDN: Use CloudFlare para servir assets mais rápido
• Backup Automático: Configure backup diário do banco e arquivos

Por que vale o esforço: bem ajustado, um Mautic num VPS modesto dá conta de bases grandes a uma fração do custo de uma plataforma SaaS equivalente. Essa economia é o que motiva boa parte de quem opta por se auto-hospedar.

Próximos Passos Após Instalar Mautic

Com o Mautic no ar, os próximos passos são:

1. Criar seus primeiros contatos e segmentos
2. Integrar com WordPress para rastrear visitantes
3. Configurar campanhas de email marketing
4. Aprender sobre lead scoring para priorizar prospects
5. Automatizar fluxos de automação de marketing

Perguntas Frequentes sobre Instalação do Mautic

Qual é o melhor método para instalar Mautic para iniciantes?

Para quem está começando, o CloudPanel ou um one-click installer resolvem sem exigir conhecimento técnico. Se você tem experiência com Linux, o método VPS dá mais controle e sai mais barato.

Posso instalar Mautic em hosting compartilhado?

Não. Hosting compartilhado não atende aos requisitos técnicos (PHP 8.3, MySQL 8.0, cron jobs dedicados). Use no mínimo um VPS ou o CloudPanel.

Quanto custa uma instalação do Mautic?

O software do Mautic é gratuito; você paga apenas a infraestrutura. Um VPS de entrada custa poucas dezenas de reais por mês, e o valor sobe conforme a base de contatos e o volume de envio crescem. Painéis como o CloudPanel têm edição gratuita, e o custo continua sendo o do próprio VPS.

Como faço backup da minha instalação do Mautic?

Faça backup do banco de dados e da pasta /var/www/mautic. Use: mysqldump -u mautic_user -p mautic > backup.sql

Posso migrar minha instalação para outro servidor?

Sim. Faça backup do banco, restaure no novo servidor, aponte o domínio para o novo IP e atualize a configuração do Mautic. Costuma levar cerca de uma hora.

Quais são as alternativas gratuitas ao Mautic?

O Mautic é a plataforma open source de automação de marketing mais completa. Ferramentas SaaS como Mailchimp e Brevo têm planos gratuitos limitados (por número de contatos ou de envios) e com automação mais restrita. O Mautic não impõe teto de contatos: o limite passa a ser o seu servidor.

Conclusão

Instalar o Mautic é acessível a qualquer nível de conhecimento técnico. Escolha o método que se adequa a você: VPS se quer controle máximo e economia, Docker se quer simplicidade, CloudPanel se quer interface visual, ou One-Click se quer o máximo de comodidade. Em menos de uma hora, você terá uma plataforma de automação de marketing rodando. Depois disso, consulte nossos guias sobre como usar o Mautic e email marketing com Mautic para começar a gerar resultados. Para as referências oficiais de cada etapa, a documentação oficial do Mautic é a fonte definitiva.