Como Instalar o SuiteCRM no Debian 12

SuiteCRM é um software de CRM (Gestão de Relacionamento com o Cliente) gratuito e de código aberto escrito em PHP. Ele ajuda você a organizar e gerenciar os departamentos de marketing, vendas e atendimento ao cliente da sua empresa. O SuiteCRM é adequado para quase todos os setores, como manufatura, setores públicos, tecnologia, finanças, educação, etc.

Neste guia, vamos orientá-lo passo a passo na instalação do SuiteCRM no servidor Debian 12. Você instalará e executará o SuiteCRM com a pilha LAMP (Apache2, MariaDB e PHP) em sua máquina Debian. Você também irá proteger o SuiteCRM com certificados SSL/TLS da Letsencrypt.

Pré-requisitos

Os seguintes requisitos são necessários para continuar com este guia:

• Um servidor Debian 12.
  Um usuário não-root com privilégios de administrador.
  Um nome de domínio apontado para um endereço IP do servidor.

Instalando Dependências

O SuiteCRM é um software de CRM escrito em PHP com MySQL/MariaDB como banco de dados. Neste guia, você executará o SuiteCRM com a pilha LAMP (Apache2, MariaDB e PHP), e agora você instalará os pacotes da pilha LAMP com extensões PHP adicionais.

Primeiro, atualize o índice de pacotes do Debian através do comando apt update abaixo.

sudo apt update

Agora instale os pacotes da pilha LAMP (Apache2, MariaDB e PHP) com algumas extensões PHP usando o seguinte comando.

sudo apt install apache2 mariadb-server php php-cli php-mysql php-bcmath php-xml php-zip php-curl php-mbstring php-gd php-tidy php-intl php-cli php-opcache php-soap php-imap php-ldap unzip

Digite y para prosseguir com a instalação.

Em seguida, execute o seguinte comando systemctl para verificar o serviço apache2. Isso garantirá que o serviço apache2 esteja habilitado e em execução.

sudo systemctl is-enabled apache2  
sudo systemctl status apache2

A saída enabled confirma que o apache2 está habilitado, e a saída active (running) confirma que o apache2 está em execução.

Verifique o serviço mariadb usando o seguinte comando.

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

Semelhante à saída do serviço apache2, você deve ver que o serviço mariadb está habilitado e em execução.

Por último, verifique a versão do PHP e algumas extensões habilitadas executando o seguinte comando.

php -v  
php -m

A seguinte saída mostra que o PHP 8.2 está instalado com alguns módulos habilitados, como curl, exif, fileinfo e gd.

Configurando o Servidor MariaDB

Após instalar as dependências, você irá proteger a instalação do seu servidor MariaDB e criar um novo banco de dados e usuário que serão usados para o SuiteCRM.

Execute o comando mariadb-secure-installation abaixo para proteger seu servidor MariaDB.

sudo mariadb-secure-installation

Durante o processo, insira Y para confirmar a configuração ou n para Não e negar as alterações.

• Mudar para autenticação unix_socket?. Insira n e pressione ENTER. O usuário root padrão do MariaDB já está protegido. Opcionalmente, você também pode habilitá-lo digitando y para sim.
• Mudar a senha do root?. Insira y para confirmar e configurar sua nova senha de root do MariaDB.
• Remover usuário anônimo?. Insira y para confirmar.
• Proibir login remoto do root? Insira y para confirmar. Apenas conexões locais serão permitidas se você estiver usando o usuário root do MariaDB.
• Remover banco de dados de teste e acesso a ele?. Insira y para confirmar e remover o banco de dados padrão ‘test’.
• Por último, insira y novamente para recarregar todos os privilégios das tabelas no seu servidor MariaDB e aplicar novas alterações.

Agora que o MariaDB está protegido, você irá criar um novo banco de dados e usuário para o SuiteCRM.

Faça login no servidor MariaDB através do comando cliente mariadb abaixo. Insira sua senha de root do MariaDB quando solicitado.

sudo mariadb -u root -p

Em seguida, execute as seguintes consultas para criar um novo banco de dados suitecrmdb e o usuário suitecrm com a senha password. Certifique-se de alterar a senha para a sua própria senha.

CREATE DATABASE suitecrmdb;  
CREATE USER 'suitecrm'@'localhost' IDENTIFIED BY 'password';  
GRANT ALL PRIVILEGES ON suitecrmdb.* TO 'suitecrm'@'localhost';  
FLUSH PRIVILEGES;

Agora execute a seguinte consulta para verificar o usuário suitecrm.

SHOW GRANTS FOR 'suitecrm'@'localhost';

Na saída a seguir, você deve ver que o usuário suitecrm tem acesso ao banco de dados suitecrmdb.

Digite quit para sair do servidor MariaDB.

Configurando o PHP

Agora que o servidor MariaDB está configurado, o próximo passo é configurar sua instalação do PHP. O SuiteCRM requer algumas alterações nas configurações do PHP, como custom error_reporting, habilitar o módulo OPCache e também custom upload_max_filesize e post_max_size.

Abra a configuração padrão do PHP /etc/php/8.2/apache2/php.ini e /etc/php/8.2/cli/php.ini usando o seguinte comando do editor nano.

sudo nano /etc/php/8.2/apache2/php.ini  
sudo nano /etc/php/8.2/cli/php.ini

Altere os parâmetros padrão de algumas configurações usando as seguintes linhas. Certifique-se de ajustar o date.timezone com o fuso horário do seu servidor e o memory_limit com a memória do servidor.

date.timezone = Europe/Amsterdam  
  
max_execution_time = 60  
memory_limit = 256M  
  
upload_max_filesize = 25M  
post_max_size = 25M

Altere o parâmetro padrão error_reporting assim:

error_reporting = E_ALL & ~E_DEPRECATED & ~E_STRICT & ~E_NOTICE & ~E_WARNING

Descomente o parâmetro session.save_path para configurar o caminho padrão da sessão para /var/lib/php/sessions.

session.save_path = "/var/lib/php/sessions"

Agora habilite a extensão OPCache e ajuste algumas configurações como as seguintes:

opcache.enable=1  
  
; O tamanho do armazenamento em memória compartilhada do OPcache.  
opcache.memory_consumption=256  
  
; O número máximo de chaves (scripts) na tabela hash do OPcache.  
; Apenas números entre 200 e 100000 são permitidos.  
opcache.max_accelerated_files=20000  
  
; Quando desativado, você deve redefinir o OPcache manualmente ou reiniciar o  
; servidor web para que as alterações no sistema de arquivos tenham efeito.  
opcache.validate_timestamps=0

Salve e feche o arquivo quando terminar.

Agora execute o seguinte comando systemctl para reiniciar o serviço apache2 e aplicar as alterações que você fez.

sudo systemctl restart apache2

Baixando e Instalando o SuiteCRM

Neste ponto, a pilha LAMP agora está configurada para o SuiteCRM. Agora você irá baixar o código-fonte do SuiteCRM e instalá-lo via linha de comando.

Crie um novo diretório /var/www/suitecrm que será usado como a instalação alvo para o SuiteCRM.

mkdir -p /var/www/suitecrm

Mova para o diretório /var/www/suitecrm e baixe o código-fonte do SuiteCRM usando o comando wget abaixo. Certifique-se de verificar a página de Download do SuiteCRM para obter a versão mais recente do código-fonte. Neste momento, o SuiteCRM 8.4 é a versão mais recente.

cd /var/www/suitecrm  
wget https://suitecrm.com/download/142/suite84/562972/suitecrm-8-4-0.zip

Uma vez baixado, extraia o arquivo suitecrm-8-4-0.zip usando o comando unzip abaixo.

unzip suitecrm-8-4-0.zip

Em seguida, execute o seguinte comando para configurar as permissões e a propriedade adequadas do código-fonte do SuiteCRM.

find . -type d -not -perm 2755 -exec chmod 2755 {} \;  
find . -type f -not -perm 0644 -exec chmod 0644 {} \;  
find . ! -user www-data -exec chown www-data:www-data {} \;  
chmod +x bin/console

Por último, execute o arquivo binário /var/www/suitecrm/bin/console para instalar o SuiteCRM via linha de comando. Certifique-se de alterar os detalhes do nome do banco de dados, usuário, host, nome de domínio alvo, usuário admin e senha que serão usados para sua instalação do SuiteCRM.

sudo -u www-data ./bin/console suitecrm:app:install -u "alice" -p "password" -U "suitecrm" -P "password" -H "127.0.0.1" -N "suitecrmdb" -S "http://suitecrm.howtoforge.local/"

Uma vez que a instalação esteja concluída, a seguinte saída será mostrada no seu terminal:

Configurando o Host Virtual do Apache2 para o Suite

No próximo passo, você irá criar uma nova configuração de host virtual do Apache2 que será usada para executar o SuiteCRM. Antes de prosseguir, certifique-se de que você tem um nome de domínio apontado para o endereço IP do seu servidor.

Execute o comando a2enmod abaixo para habilitar os módulos do Apache2 que são necessários para o SuiteCRM.

sudo a2enmod rewrite ssl header

Em seguida, crie uma nova configuração de host virtual do Apache2 /etc/apache2/sites-available/suitecrm.conf usando o seguinte comando do editor nano.

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

Insira a seguinte configuração e certifique-se de alterar a opção ServerName com seu nome de domínio.

  
  
 DocumentRoot /var/www/suitecrm/public  
 ServerName suitecrm.howtoforge.local  
  
   
    Options FollowSymLinks  
    AllowOverride All  
   
  
 ErrorLog /var/log/apache2/suitecrm-error.log  
 CustomLog /var/log/apache2/suitecrm-access.log common  
  

Salve e feche o arquivo quando terminar.

Agora execute o seguinte comando para ativar o arquivo de host virtual suitecrm.conf e verificar suas configurações do Apache2.

sudo a2ensite suitecrm.conf  
sudo apachectl configtest

Se você tiver a sintaxe correta, deverá obter a saída Syntax OK.

Em seguida, execute o comando systemctl abaixo para reiniciar o serviço apache2 e aplicar as alterações.

sudo systemctl restart apache2

Por último, abra seu navegador da web e visite o nome de domínio da sua instalação do SuiteCRM, como http://suitecrm.howtoforge.local/. Se tudo correr bem, você deverá ver a página de login do SuiteCRM.

Protegendo o SuiteCRM com SSL/TLS da Letsencrypt

Com tudo configurado, você agora irá proteger o SuiteCRM com certificados SSL/TLS da Letsencrypt.

Instale o Certbot e o plugin Certbot Apache usando o seguinte comando apt install. Digite y para prosseguir com a instalação.

sudo apt install certbot python3-certbot-apache

Agora execute o comando certbot abaixo para gerar certificados SSL/TLS. Certifique-se de alterar o nome de domínio e o endereço de e-mail dentro do seguinte comando.

sudo certbot --apache --agree-tos --no-eff-email  --redirect --hsts --staple-ocsp --email [email protected] -d suitecrm.howtoforge.local

Uma vez que o processo esteja concluído, seus certificados SSL serão gerados no diretório /etc/letsencrypt/live/suitecrm.howtoforge.local. Além disso, o arquivo de host virtual do SuiteCRM suitecrm.conf será automaticamente configurado com HTTPS.

Volte ao seu navegador da web e visite o nome de domínio do seu SuiteCRM, você deve ser redirecionado para a página de login do SuiteCRM para conexões HTTPS seguras. Insira seu usuário admin e senha, em seguida, clique em Login.

Se tudo correr bem, você deverá ver o painel de administração do SuiteCRM como o seguinte:

Conclusão

Para concluir, você agora instalou com sucesso o SuiteCRM no servidor Debian 12 com a pilha LAMP (Apache2, MariaDB e PHP). Você também protegeu o SuiteCRM com SSL/TLS Letsencrypt, que foi gerado via Certbot. Agora você pode usar o SuiteCRM como o principal aplicativo de CRM (Gestão de Relacionamento com o Cliente) para sua empresa, e você pode começar adicionando o servidor SMTP à sua instalação do SuiteCRM.