Como instalar o Mautic: guia completo de instalação em servidor Linux

Instalar o Mautic não é tão complicado quanto parece — mas exige atenção aos detalhes. Uma instalação feita corretamente desde o início evita horas de troubleshooting mais tarde. Este guia cobre o processo completo de como instalar o Mautic em um servidor Ubuntu/Debian com Apache, PHP e MySQL — a stack mais comum para hospedagem self-hosted da plataforma.

Se você já leu sobre o Mautic e decidiu que quer rodar sua própria instância, este é o ponto de partida: um passo a passo detalhado que leva desde o servidor limpo até o painel do Mautic funcionando com HTTPS.

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

# Baixar a versão mais recente (verifique 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 Composer
curl -sS https://getcomposer.org/installer | php
sudo mv composer.phar /usr/local/bin/composer

# Criar 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

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 renova o certificado a cada 90 dias. 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 será exibido em três etapas:

1. Verificação de requisitos: O instalador valida se todas as extensões PHP e 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), nome do banco (mautic), usuário e senha criados anteriormente. Clique em “Next” para criar as tabelas.
3. Criação do administrador: Defina nome, email e senha do usuário admin. Defina também o fuso horário (America/Sao_Paulo) e o idioma (pt_BR).

Configurar os CRONs após a instalação

Sem os CRONs, o Mautic não processa campanhas, não envia emails e não atualiza segmentos. Configure com sudo crontab -e -u www-data:

*/5 * * * * /usr/bin/php /var/www/mautic/bin/console mautic:campaigns:trigger --no-interaction >> /dev/null 2>&1
*/5 * * * * /usr/bin/php /var/www/mautic/bin/console mautic:emails:send --no-interaction >> /dev/null 2>&1
*/30 * * * * /usr/bin/php /var/www/mautic/bin/console mautic:campaigns:rebuild --no-interaction >> /dev/null 2>&1
*/30 * * * * /usr/bin/php /var/www/mautic/bin/console mautic:segments:update --no-interaction >> /dev/null 2>&1
0 3 * * * /usr/bin/php /var/www/mautic/bin/console mautic:contacts:deduplicate --no-interaction >> /dev/null 2>&1

Perguntas frequentes sobre instalação do Mautic

Conclusão

Instalar o Mautic em um servidor Linux é um processo que pode ser concluído em menos de uma hora por quem tem familiaridade básica com terminal. O mais importante é garantir que os requisitos de PHP sejam atendidos, o HTTPS esteja configurado e os CRONs estejam funcionando antes de qualquer outra coisa.

Após a instalação, explore a configuração de email SMTP e crie sua primeira campanha. Para mais conteúdos sobre o Mautic, acesse os artigos de Mautic no atraca.com.br ou consulte a documentação oficial de instalação do Mautic.