Laboratório: Implantação do SuiteCRM em ambiente local com MariaDB e Apache

Duração estimada

90 min

Passos

10

Validações

4

Versões da documentação consultada

SuiteCRM 8.x (consulte a documentação) · MariaDB 10.6 (versão estável atual) · Apache HTTP Server 2.4.x (versão estável atual) · PHP 8.0 ou superior (consulte a documentação)

Topologia

Uma máquina virtual Linux (ex: Ubuntu Server 22.04) com IP 192.168.56.10, rodando Apache, PHP e MariaDB. O SuiteCRM será acessado pelo navegador de outro dispositivo na mesma rede privada.

┌───────────────┐      HTTP(S)      ┌─────────────┐
│  Navegador   │ <--------------> │  VM Linux   │
│192.168.56.20 │                  │192.168.56.10│
└───────────────┘                  │ Apache      │
                                   │ PHP         │
                                   │ MariaDB     │
                                   │ SuiteCRM    │
                                   └─────────────┘

Equipamentos e software

Roteiro

1. Preparar a VM Linux

   Por que: Garantir ambiente limpo e atualizado. Como: Atualize pacotes e instale utilitários básicos.

   sudo apt update && sudo apt upgrade -y
   sudo apt install unzip wget curl -yCopiar

   O que você deve ver: Sistema atualizado e utilitários instalados sem erros.

2. Instalar Apache

   Por que: SuiteCRM precisa de um servidor web. Como: Instale o Apache.

   sudo apt install apache2 -yCopiar

   O que você deve ver: Apache instalado. Serviço rodando em http://192.168.56.10/

3. Instalar PHP e extensões necessárias

   Por que: SuiteCRM exige PHP e módulos específicos. Como: Instale PHP e extensões.

   sudo apt install php php-mbstring php-xml php-mysql php-zip php-gd php-curl php-imap php-cli php-soap php-intl -yCopiar

   O que você deve ver: PHP e extensões instalados sem erros.

4. Instalar MariaDB

   Por que: SuiteCRM armazena dados em banco relacional. Como: Instale MariaDB.

   sudo apt install mariadb-server mariadb-client -yCopiar

   O que você deve ver: MariaDB instalado e rodando.

5. Configurar o banco de dados

   Por que: SuiteCRM precisa de um banco dedicado. Como: Crie banco e usuário.

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

   O que você deve ver: Banco e usuário criados sem erros.

6. Baixar e descompactar o SuiteCRM

   Por que: Precisa dos arquivos do sistema. Como: Baixe e extraia na pasta web.

   cd /tmp
   wget https://github.com/salesagility/SuiteCRM/archive/refs/heads/master.zip
   unzip master.zip
   sudo mv SuiteCRM-master /var/www/html/suitecrmCopiar

   O que você deve ver: Arquivos do SuiteCRM copiados para /var/www/html/suitecrm.

7. Ajustar permissões

   Por que: Apache precisa ler e gravar em diretórios do SuiteCRM. Como: Ajuste permissões.

   sudo chown -R www-data:www-data /var/www/html/suitecrm
   sudo find /var/www/html/suitecrm -type d -exec chmod 755 {} \;
   sudo find /var/www/html/suitecrm -type f -exec chmod 644 {} \;Copiar

   O que você deve ver: Permissões ajustadas. Sem erros de permissão ao acessar via web.

8. Configurar Apache para SuiteCRM

   Por que: Melhor isolar o acesso. Como: Crie virtual host dedicado.

   sudo tee /etc/apache2/sites-available/suitecrm.conf > /dev/null <<EOF
   <VirtualHost *:80>
       ServerAdmin admin@exemplo.local
       DocumentRoot /var/www/html/suitecrm/public
       ServerName suitecrm.local
       <Directory /var/www/html/suitecrm/public>
           AllowOverride All
           Require all granted
       </Directory>
       ErrorLog ${APACHE_LOG_DIR}/suitecrm_error.log
       CustomLog ${APACHE_LOG_DIR}/suitecrm_access.log combined
   </VirtualHost>
   EOF
   sudo a2ensite suitecrm.conf
   sudo a2enmod rewrite
   sudo systemctl reload apache2Copiar

   O que você deve ver: Virtual host ativo. SuiteCRM acessível em http://suitecrm.local/ (ajuste hosts se necessário).

9. Instalar SuiteCRM via navegador

   Por que: Finalizar configuração e criar admin. Como: Acesse pelo navegador e siga o wizard.

   O que você deve ver: Tela de instalação do SuiteCRM. Wizard solicita dados do banco e usuário admin.

10. Finalizar instalação e login

    Por que: Validar acesso e funcionamento. Como: Complete o wizard e faça login.

    O que você deve ver: Dashboard do SuiteCRM carregado após login.

Como saber que funcionou

Troubleshooting

Segurança e hardening

• Altere a senha padrão do banco de dados por uma forte
• Restrinja o acesso ao banco apenas ao host local
• Remova arquivos de instalação do SuiteCRM após concluir o wizard
• Mantenha o sistema operacional e todos os pacotes atualizados
• Considere usar HTTPS em produção

Checklist final

• VM Linux criada e atualizada
• Apache, PHP e MariaDB instalados
• Banco de dados e usuário criados
• SuiteCRM extraído e permissões ajustadas
• Virtual host configurado e ativo
• SuiteCRM instalado e acessível via navegador
• Login no dashboard realizado