Como instalar o Mautic?

Instalar o Mautic é, no fundo, montar uma stack bem configurada — PHP 8.x, MySQL ou MariaDB e um servidor web com HTTPS — e, acima de tudo, deixar os CRON jobs rodando desde o primeiro dia. Sem eles, a plataforma até abre, mas não dispara campanhas, não envia e-mails e não atualiza segmentos.

O Mautic é uma plataforma open-source de automação de marketing self-hosted: você mesmo instala e opera em um servidor próprio. Este guia cobre a instalação completa em um servidor Ubuntu ou Debian com Apache, PHP e MySQL — a stack mais comum para hospedar o Mautic. Do servidor limpo ao painel funcionando com HTTPS, o caminho segue etapas bem definidas:

Requisitos: o que o servidor precisa ter

Antes de baixar qualquer coisa, confira se o servidor atende aos componentes que o Mautic exige. Diferente de muitos scripts PHP, ele depende de um banco relacional específico (MySQL ou MariaDB — não Postgres) e do acesso ao cron do sistema.

Pré-requisitos: preparando o servidor

1. Atualizar o sistema

sudo apt update && sudo apt upgrade -y

2. Instalar o PHP 8.1 e extensões obrigatórias

sudo apt install -y software-properties-common
sudo add-apt-repository ppa:ondrej/php -y
sudo apt update
sudo apt install -y php8.1 php8.1-cli php8.1-common php8.1-curl \
  php8.1-dom php8.1-gd php8.1-intl php8.1-mbstring php8.1-mysql \
  php8.1-opcache php8.1-xml php8.1-zip php8.1-imap php8.1-bcmath

3. Instalar o Apache e habilitar mod_rewrite

sudo apt install -y apache2
sudo a2enmod rewrite
sudo a2enmod headers
sudo a2enmod ssl
sudo systemctl restart apache2

4. Instalar o MySQL

sudo apt install -y mysql-server
sudo mysql_secure_installation

Após a instalação, crie o banco de dados e o usuário para o Mautic:

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

Baixar e instalar o Mautic

Método 1: download do pacote ZIP

# Baixe a versão mais recente (confira a versão atual em github.com/mautic/mautic/releases)
cd /var/www/
sudo wget https://github.com/mautic/mautic/releases/download/5.1.1/5.1.1.zip -O mautic.zip
sudo apt install -y unzip
sudo unzip mautic.zip -d mautic
sudo rm mautic.zip

# Ajustar permissões
sudo chown -R www-data:www-data /var/www/mautic
sudo chmod -R 755 /var/www/mautic
sudo chmod -R 775 /var/www/mautic/var /var/www/mautic/app/cache \
  /var/www/mautic/app/logs /var/www/mautic/media

Método 2: instalação via Composer

# Instalar o Composer
curl -sS https://getcomposer.org/installer | php
sudo mv composer.phar /usr/local/bin/composer

# Criar o projeto Mautic
cd /var/www/
sudo composer create-project mautic/recommended-project:^5 mautic --no-interaction
sudo chown -R www-data:www-data /var/www/mautic

E o Docker? Se você prefere isolar as dependências, a imagem oficial mautic/mautic é uma das formas mais populares de rodar a plataforma hoje. O fluxo geral é o mesmo deste guia (banco, instalador, admin, cron), mas empacotado em contêineres — os CRON jobs continuam obrigatórios, rodados por um serviço dedicado ao lado da aplicação.

Configurar o Virtual Host do Apache

sudo nano /etc/apache2/sites-available/mautic.conf

Insira o conteúdo abaixo (substitua mautic.seudominio.com.br pelo seu domínio):

<VirtualHost *:80>
    ServerName mautic.seudominio.com.br
    DocumentRoot /var/www/mautic

    <Directory /var/www/mautic>
        AllowOverride All
        Require all granted
        Options -Indexes
    </Directory>

    ErrorLog ${APACHE_LOG_DIR}/mautic_error.log
    CustomLog ${APACHE_LOG_DIR}/mautic_access.log combined
</VirtualHost>

sudo a2ensite mautic.conf
sudo a2dissite 000-default.conf
sudo systemctl reload apache2

Instalar o certificado SSL com Let's Encrypt

sudo apt install -y certbot python3-certbot-apache
sudo certbot --apache -d mautic.seudominio.com.br

O Certbot configura o HTTPS automaticamente e cuida da renovação do certificado. Verifique que o domínio já aponta para o IP do servidor antes de executar o Certbot.

Concluir a instalação via interface web

Acesse https://mautic.seudominio.com.br no navegador. O instalador web do Mautic aparece em três etapas:

1. Verificação de requisitos: o instalador valida se todas as extensões PHP e as permissões estão corretas. Corrija qualquer item marcado em vermelho antes de prosseguir.
2. Configuração do banco de dados: informe o host (localhost), o nome do banco (mautic), o usuário e a senha criados anteriormente. Clique em Next para criar as tabelas.
3. Criação do administrador: defina nome, e-mail e senha do usuário admin. Ajuste também o fuso horário (America/Sao_Paulo) e o idioma (pt_BR).

Configurar os CRON jobs após a instalação

Este é o passo que mais gente esquece — e o que faz o Mautic parecer "quebrado". Sem os CRON jobs, ele não atualiza segmentos, não processa nem dispara campanhas e não envia e-mails. Os quatro comandos essenciais para uma instalação em produção são estes; agende-os com sudo crontab -e -u www-data:

*/15 * * * * /usr/bin/php /var/www/mautic/bin/console mautic:segments:update --no-interaction >> /dev/null 2>&1
*/15 * * * * /usr/bin/php /var/www/mautic/bin/console mautic:campaigns:update --no-interaction >> /dev/null 2>&1
*/15 * * * * /usr/bin/php /var/www/mautic/bin/console mautic:campaigns:trigger --no-interaction >> /dev/null 2>&1
*/15 * * * * /usr/bin/php /var/www/mautic/bin/console mautic:emails:send --no-interaction >> /dev/null 2>&1

Em bases maiores, o recomendado é escalonar os horários para que os comandos não rodem sobrepostos. Para entender o papel de cada um e os intervalos ideais, veja quais crons o Mautic precisa.

Ajuste as configurações do PHP para o Mautic. O PHP padrão do Ubuntu tem limites conservadores que podem causar timeouts durante a instalação e o uso da plataforma. Edite /etc/php/8.1/apache2/php.ini e ajuste memory_limit = 512M, max_execution_time = 300, upload_max_filesize = 64M e post_max_size = 64M. Reinicie o Apache depois: sudo systemctl restart apache2.

Perguntas frequentes sobre instalar o Mautic

Quais são os requisitos mínimos para instalar o Mautic?

O Mautic roda em PHP 8.x com várias extensões (curl, gd, intl, mbstring, mysql, xml, zip, entre outras), precisa de um banco MySQL 8.0+ ou MariaDB 10.6+ e de um servidor web como Apache ou Nginx. HTTPS é praticamente obrigatório para rastreamento e formulários, e você precisa de acesso ao crontab do sistema para os CRON jobs. Um VPS Linux com 2 vCPUs e 4 GB de RAM atende bem instalações pequenas e médias.

Posso instalar o Mautic em hospedagem compartilhada?

Tecnicamente é possível quando a hospedagem oferece PHP 8.x, MySQL e acesso SSH, mas raramente é uma boa ideia. A maioria dos planos compartilhados impõe limites de memória, CPU e processos que deixam o Mautic lento ou instável, e a falta de acesso ao crontab do sistema dificulta os CRON jobs. Para produção, um VPS é fortemente recomendado.

Por que os CRON jobs são obrigatórios no Mautic?

Porque o Mautic delega boa parte do trabalho pesado ao cron: é ele que atualiza os segmentos, reconstrói e dispara as campanhas e envia os e-mails da fila. Sem os CRON jobs configurados, o painel abre normalmente, mas nada é processado em segundo plano — campanhas param e e-mails não saem. Por isso, configure-os logo após concluir a instalação.

Dá para instalar o Mautic com Docker?

Sim. Existe uma imagem Docker oficial do Mautic, e essa é uma das formas mais usadas hoje, porque isola as dependências de PHP e facilita atualizações e backups. Ainda assim, os CRON jobs continuam necessários — normalmente rodados por um contêiner ou serviço dedicado ao lado do contêiner da aplicação.

Como atualizar o Mautic após a instalação?

Sempre faça um backup completo antes — banco de dados e arquivos. O Mautic tem um atualizador integrado em Admin > Update para versões menores; para saltos de versão maior, siga as notas de release da documentação oficial, que às vezes exigem passos manuais. Nunca atualize direto em produção sem testar antes em um ambiente de staging.

Conclusão

Instalar o Mautic em um servidor Linux é um processo que quem tem familiaridade básica com terminal conclui em menos de uma hora. O mais importante é garantir que os requisitos de PHP e banco estejam atendidos, que o HTTPS esteja configurado e que os CRON jobs estejam rodando antes de qualquer outra coisa.

Com o painel no ar, o próximo passo é configurar o envio de e-mail via SMTP e criar a primeira campanha. Para mais conteúdos sobre a plataforma, acesse os artigos de Mautic no atraca.com.br ou consulte a documentação oficial de instalação do Mautic.