Como Instalar Acelle Mail na VPS: Guia Completo

Instalar Acelle Mail na VPS: Plataforma de E-mail Marketing Open Source

No cenário atual de marketing digital, o controle sobre os dados dos clientes e a otimização de custos operacionais são diferenciais estratégicos. Plataformas SaaS tradicionais cobram por contato ou por volume de envio, o que pode tornar-se proibitivo para empresas em crescimento. A solução ideal para muitos profissionais de TI e marketers técnicos é a implementação de uma plataforma e-mail marketing self-hosted. Neste tutorial, vamos guiar você através do processo completo para instalar acelle mail vps, transformando sua infraestrutura Linux em um motor poderoso de automação de marketing.

O Acelle Mail é uma ferramenta open source robusta, baseada em Laravel (PHP), projetada para gerenciar campanhas, listas de assinantes e métricas de entrega. Ao rodá-lo em um servidor próprio vps, você elimina a dependência de terceiros e garante que seus dados permaneçam sob sua total soberania. Este guia é focado em ambientes Ubuntu/Debian, mas os conceitos aplicam-se a outras distribuições Linux.

Pré-requisitos e Preparação do Ambiente

Antes de iniciar a instalação, é fundamental garantir que o ambiente esteja preparado para lidar com as demandas de envio de e-mails e processamento de dados. Um tutorial acelle bem-sucedido depende diretamente da saúde da infraestrutura subjacente.

1. Requisitos de Hardware

O Acelle Mail não é extremamente pesado, mas o processamento de filas de e-mail e a geração de relatórios consomem recursos. Recomendamos:

• CPU: Mínimo 2 vCores.
• RAM: 4GB ou mais (recomendável para evitar erros de memória durante o envio em massa).
• Disco: SSD com pelo menos 40GB livres.
• Sistema Operacional: Ubuntu 20.04 LTS ou 22.04 LTS (recomendado).

2. Configuração de DNS e IP Respeitável

Para garantir que seus e-mails não caiam no spam, você precisa configurar corretamente os registros DNS. Isso é crítico para qualquer newsletter linux profissional.

1. IP Dedicado: Certifique-se de que sua VPS tenha um IP dedicado e não esteja na blacklist do RBL (Real-time Blackhole List).
2. Reverse DNS (PTR): Configure o PTR do seu IP no painel da sua hospedagem para apontar para o hostname do servidor (ex: mail.seudominio.com).
3. Registros SPF, DKIM e DMARC: Embora o Acelle gerencie a assinatura DKIM internamente, você deve publicar os registros de autorização no seu DNS. O SPF deve permitir o IP da sua VPS enviar e-mails em nome do seu domínio.

Passo 1: Atualização do Sistema e Instalação de Dependências Básicas

O primeiro passo lógico é atualizar os pacotes existentes e instalar ferramentas essenciais para compilação e gerenciamento de arquivos. Conecte-se ao seu servidor via SSH.

sudo apt update && sudo apt upgrade -y
sudo apt install curl wget unzip git nano htop -y

Agora, instalaremos o PostgreSQL, que é o banco de dados recomendado para aplicações Laravel em produção devido à sua estabilidade e suporte a JSON. O MySQL também funciona, mas o PostgreSQL oferece melhor desempenho em consultas complexas.

sudo apt install postgresql postgresql-contrib -y

Passo 2: Instalação do PHP e Extensões Necessárias

O Acelle Mail é construído sobre o framework Laravel, exigindo uma versão específica do PHP. Verificamos a versão disponível no repositório padrão do Ubuntu.

sudo apt install software-properties-common -y
sudo add-apt-repository ppa:ondrej/php -y
sudo apt update

Instale o PHP 8.1 ou superior, junto com todas as extensões necessárias para o funcionamento correto do e-mail, criptografia e manipulação de imagens.

sudo apt install php8.2-fpm php8.2-cli php8.2-common php8.2-mysql php8.2-zip php8.2-gd php8.2-mbstring php8.2-curl php8.2-xml php8.2-bcmath php8.2-intl php8.2-imap php8.2-ldap php8.2-redis php8.2-sqlite3 -y

Atenção: A extensão php8.2-redis é crucial se você planeja usar o Redis para filas de e-mail, o que melhora drasticamente a performance em automação de marketing de alto volume.

Passo 3: Instalação do Composer e Node.js

O Composer é o gerenciador de dependências do PHP, e o Node.js é necessário para compilar os assets frontend (CSS/JS) do Acelle Mail.

Instalando o Composer:

cd /tmp
curl -sS https://getcomposer.org/installer | php
sudo mv composer.phar /usr/local/bin/composer

Instalando o Node.js e Yarn:

curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt install nodejs -y
sudo npm install -g yarn

Passo 4: Configuração do Banco de Dados

Crie um banco de dados dedicado e um usuário com privilégios para o Acelle Mail. Isso é uma prática de segurança essencial.

sudo -u postgres psql

Dentro do prompt SQL, execute:

CREATE DATABASE acelle_db;
CREATE USER acelle_user WITH PASSWORD 'senha_forte_aqui';
ALTER ROLE acelle_user SET client_encoding TO 'utf8';
ALTER ROLE acelle_user SET default_transaction_isolation TO 'read committed';
ALTER ROLE acelle_user SET timezone TO 'UTC';
GRANT ALL PRIVILEGES ON DATABASE acelle_db TO acelle_user;
\q

Passo 5: Download e Extração do Acelle Mail

Acesse o diretório raiz do web server (geralmente /var/www/html) e baixe os arquivos. Você pode baixar a versão estável diretamente do repositório oficial ou usar o Git.

cd /var/www
sudo git clone https://github.com/acellemail/acelle-mail.git
cd acelle-mail
sudo git checkout v1.2.0 # Verifique a versão mais recente no GitHub

Ajuste as permissões de diretório para que o usuário do web server (geralmente www-data) possa escrever nos diretórios necessários.

sudo chown -R www-data:www-data /var/www/acelle-mail
sudo chmod -R 755 /var/www/acelle-mail

Passo 6: Instalação das Dependências PHP e Compilação Frontend

Agora, instale as dependências do projeto via Composer. Isso pode levar alguns minutos dependendo da velocidade da sua conexão.

cd /var/www/acelle-mail
sudo -u www-data composer install --no-dev --optimize-autoloader

Em seguida, compile os assets do frontend usando o Yarn:

sudo -u www-data yarn install
sudo -u www-data yarn production

Passo 7: Configuração do Arquivo .env

O arquivo .env é o coração da configuração do Acelle. Copie o modelo e edite-o com suas credenciais.

sudo cp .env.example .env
sudo nano .env

Altere as seguintes variáveis principais:

• APP_NAME=Acelle Mail
• APP_ENV=production
• APP_KEY= (Gerar chave com php artisan key:generate)
• DB_CONNECTION=pgsql
• DB_HOST=127.0.0.1
• DB_PORT=5432
• DB_DATABASE=acelle_db
• DB_USERNAME=acelle_user
• DB_PASSWORD=senha_forte_aqui

Gere a chave da aplicação:

sudo -u www-data php artisan key:generate

Passo 8: Instalação do Nginx e Configuração do Virtual Host

O Nginx é o servidor web mais eficiente para esse tipo de aplicação.

sudo apt install nginx -y

Crie um arquivo de configuração no /etc/nginx/sites-available/.

sudo nano /etc/nginx/sites-available/acelle-mail

Insira a seguinte configuração (ajuste o server_name para seu domínio):

server {
    listen 80;
    server_name mail.seudominio.com;
    root /var/www/acelle-mail/public;
    index index.php index.html;

    charset utf-8;

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

    location = /favicon.ico { access_log off; log_not_found off; }
    location = /robots.txt  { access_log off; log_not_found off; }

    access_log /var/log/nginx/acelle-mail.access.log;
    error_log  /var/log/nginx/acelle-mail.error.log;

    sendfile off;

    client_max_body_size 100m;

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/var/run/php/php8.2-fpm.sock;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }

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

Habilite o site e teste a configuração:

sudo ln -s /etc/nginx/sites-available/acelle-mail /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl restart nginx

Passo 9: Configuração do Supervisor para Filas (Queues)

Para automação de marketing eficiente, o envio de e-mails não deve bloquear a interface web. O Acelle usa filas. Precisamos de um gerenciador de processos.

sudo apt install supervisor -y
sudo nano /etc/supervisor/conf.d/acelle-mail.conf

Adicione:

[program:acelle-mail]
process_name=%(program_name)s_%(process_num)02d
command=php /var/www/acelle-mail/artisan queue:work redis --sleep=3 --tries=3
autostart=true
autorestart=true
stopwaitsecs=3600
numprocs=4
user=www-data

Atualize e inicie o supervisor:

sudo supervisorctl reread
sudo supervisorctl update
sudo supervisorctl start "acelle-mail:*"

Passo 10: Acesso Web e Conclusão

Acesse http://mail.seudominio.com no seu navegador. O instalador web irá detectar o ambiente e pedir para confirmar a criação das tabelas no banco de dados.

Crie o primeiro usuário administrador. Após o login, configure as configurações do servidor SMTP (se for usar um serviço externo como SES ou SendGrid) ou ative o envio direto se souber configurar corretamente o Postfix/Dovecot no Linux.

Para segurança adicional, considere instalar um certificado SSL Let's Encrypt usando Certbot:

sudo apt install certbot python3-certbot-nginx -y
sudo certbot --nginx -d mail.seudominio.com

Melhores Práticas Pós-Instalação

Apenas instalar acelle mail vps não garante o sucesso. Para manter sua plataforma e-mail marketing saudável:

• Monitoramento: Use ferramentas como Zabbix ou Prometheus para monitorar o uso de CPU e RAM do processo PHP-FPM.
• Backups: Automatize backups do banco de dados PostgreSQL e do diretório /var/www/acelle-mail.
• Logs: Monitore os logs do Nginx e do Supervisor para detectar erros de envio ou falhas nas filas.

Com este guia, você possui uma infraestrutura sólida para gerenciar suas campanhas. A flexibilidade do código open source permite personalizações profundas, tornando esta a escolha preferida de quem busca controle total sobre sua newsletter linux.