Como Instalar o SuiteCRM no Ubuntu 20.04

SuiteCRM é um sistema CRM gratuito, de código aberto e de classe empresarial desenvolvido pela SalesAgility. É um fork da edição comunitária do SugarCRM. Ele vem com todas as funcionalidades necessárias para executar qualquer negócio com necessidades de CRM e ERP. Oferece uma ampla gama de recursos, incluindo marketing por e-mail, integração com redes sociais, automação de marketing, integração de chat interno, armazenamento de documentos, lembretes, gerenciamento de tarefas e muito mais. Este post mostrará como instalar o SuiteCRM com Nginx e SSL Let’s Encrypt no Ubuntu 20.04.

Pré-requisitos

Um servidor rodando Ubuntu 20.04.
Um nome de domínio válido apontado para o IP do seu servidor.
Uma senha de root configurada no servidor.

Começando

Antes de começar, você precisará atualizar os pacotes do seu sistema para a versão mais recente. Você pode atualizá-los usando o seguinte comando:

apt-get update -y

Uma vez que seu servidor esteja atualizado, você pode prosseguir para o próximo passo.

Instalar Nginx, MariaDB e PHP

Primeiro, você precisará instalar o servidor web Nginx, MariaDB, PHP e outras extensões PHP no seu servidor. Você pode instalar todos eles usando o seguinte comando:

apt-get install nginx mariadb-server php7.4 php7.4-fpm php7.4-gd php7.4-opcache php7.4-mbstring php7.4-xml php7.4-json php7.4-zip php7.4-curl php7.4-imap php-mysql unzip -y

Após instalar todos os pacotes, edite o arquivo php.ini e altere as configurações recomendadas:

nano /etc/php/7.4/fpm/php.ini

Altere as seguintes configurações:

post_max_size = 60M
upload_max_filesize = 60M
memory_limit = 256M
max_input_time = 60
max_execution_time = 5000
date.timezone = Asia/Kolkata

Salve e feche o arquivo, então reinicie o serviço PHP-FPM para aplicar as alterações.

systemctl restart php7.4-fpm

Neste ponto, o servidor LEMP está instalado no seu servidor. Você pode agora prosseguir para o próximo passo.

Criar um Banco de Dados para o SuiteCRM

O SuiteCRM requer um banco de dados para armazenar seus conteúdos. Primeiro, faça login no shell do MariaDB usando o seguinte comando:

mysql

Uma vez logado, crie um banco de dados e um usuário com o seguinte comando:

MariaDB [(none)]> CREATE DATABASE suitecrm;  
MariaDB [(none)]> GRANT ALL PRIVILEGES ON suitecrm.* TO 'suitecrm'@'localhost' IDENTIFIED BY 'password';

Em seguida, você precisará atualizar os privilégios para aplicar as alterações.

MariaDB [(none)]> FLUSH PRIVILEGES;

Em seguida, saia do console do MariaDB com o seguinte comando:

MariaDB [(none)]> EXIT;

Agora, você tem um banco de dados e usuários prontos para o SuiteCRM. Você pode agora prosseguir para o próximo passo.

Instalar o SuiteCRM

Primeiro, vá para o site oficial do SuiteCRM e baixe a versão mais recente do SuiteCRM usando o seguinte comando:

wget https://sourceforge.net/projects/suitecrm/files/SuiteCRM-7.11.19.zip

Uma vez que o download esteja completo, descompacte o arquivo baixado com o seguinte comando:

unzip SuiteCRM-7.11.19.zip

Em seguida, mova o diretório extraído para o diretório raiz do Nginx com o seguinte comando:

mv SuiteCRM-7.11.19 /var/www/html/suitecrm

Em seguida, defina as permissões e a propriedade adequadas para o diretório suitecrm:

chown -R www-data:www-data /var/www/html/suitecrm/  
chmod 755 -R /var/www/html/suitecrm/

Uma vez que você tenha terminado, pode prosseguir para configurar o Nginx.

Configurar o Nginx para Hospedar o SuiteCRM

Em seguida, você precisará criar um arquivo de configuração de host virtual do Nginx para hospedar o SuiteCRM na internet. Você pode criá-lo com o seguinte comando:

nano /etc/nginx/conf.d/suitecrm.conf

Adicione as seguintes linhas:

server {
   listen 80;
   server_name suitecrm.example.com;

   root /var/www/html/suitecrm;
   error_log /var/log/nginx/suitecrm.error;
   access_log /var/log/nginx/suitecrm.access;
   client_max_body_size 20M;

   index index.php index.html index.htm index.nginx-debian.html;

   location / {
     # tente servir o arquivo diretamente, fallback para app.php
     try_files $uri /index.php$is_args$args;
   }

   location ~ \.php$ {
     include snippets/fastcgi-php.conf;
     fastcgi_pass unix:/run/php/php7.4-fpm.sock;
   }

   location ~* ^/index.php {
     # try_files $uri =404;
     fastcgi_split_path_info ^(.+\.php)(/.+)$;
     # NOTA: Você deve ter "cgi.fix_pathinfo = 0;" no php.ini

     fastcgi_pass unix:/var/run/php/php7.4-fpm.sock;
     fastcgi_index index.php;
     fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
     include fastcgi_params;

     fastcgi_buffer_size 128k;
     fastcgi_buffers 256 16k;
     fastcgi_busy_buffers_size 256k;
     fastcgi_temp_file_write_size 256k;
   }

    # Não registrar favicon
    location = /favicon.ico {
        log_not_found off;
        access_log off;
    }

    # Não registrar robôs
    location = /robots.txt  {
        access_log off;
        log_not_found off;
    }

    # Negar todas as tentativas de acessar arquivos/pastas ocultos como .htaccess, .htpasswd, .DS_Store (Mac), etc...
    location ~ \. {
        deny all;
        access_log off;
        log_not_found off;
    }

     # Um longo tempo de cache do navegador pode acelerar visitas repetidas à sua página
  location ~* \.(jpg|jpeg|gif|png|webp|svg|woff|woff2|ttf|css|js|ico|xml)$ {
       access_log        off;
       log_not_found     off;
       expires           360d;
  }
}

Salve e feche o arquivo quando terminar, então verifique o Nginx para qualquer erro de sintaxe usando o seguinte comando:

nginx -t

Você deve obter a seguinte saída:

nginx: o arquivo de configuração /etc/nginx/nginx.conf está ok
nginx: o teste do arquivo de configuração /etc/nginx/nginx.conf foi bem-sucedido

Em seguida, reinicie o serviço Nginx para aplicar as alterações:

systemctl restart nginx

Para verificar o status do serviço Nginx, execute o seguinte comando:

systemctl status nginx

Você deve obter a seguinte saída:

? nginx.service - Um servidor web de alto desempenho e um servidor proxy reverso
     Loaded: loaded (/lib/systemd/system/nginx.service; enabled; vendor preset: enabled)
     Active: active (running) since Sat 2021-05-22 10:16:45 UTC; 4s ago
       Docs: man:nginx(8)
    Process: 18988 ExecStartPre=/usr/sbin/nginx -t -q -g daemon on; master_process on; (code=exited, status=0/SUCCESS)
    Process: 19000 ExecStart=/usr/sbin/nginx -g daemon on; master_process on; (code=exited, status=0/SUCCESS)
   Main PID: 19001 (nginx)
      Tasks: 2 (limit: 2353)
     Memory: 2.7M
     CGroup: /system.slice/nginx.service
             ??19001 nginx: processo mestre /usr/sbin/nginx -g daemon on; master_process on;
             ??19002 nginx: processo trabalhador

May 22 10:16:45 ubuntu2004 systemd[1]: Iniciando um servidor web de alto desempenho e um servidor proxy reverso...
May 22 10:16:45 ubuntu2004 systemd[1]: Iniciado um servidor web de alto desempenho e um servidor proxy reverso.

Neste ponto, o Nginx está configurado para servir o SuiteCRM. Você pode agora prosseguir para acessar o SuiteCRM.

Acessar o SuiteCRM

Agora, abra seu navegador web e acesse o SuiteCRM usando a URL http://suitecrm.example.com. Você deve ver a seguinte página:

Aceite o contrato de licença e clique no botão Próximo. Você deve ver a seguinte página:

Certifique-se de que todos os pré-requisitos estão instalados e clique no botão Próximo. Você deve ver a seguinte página:

Forneça o nome do seu banco de dados, usuário, senha, nome de usuário do admin, senha, URL do SuiteCRM, endereço de e-mail e clique no botão Próximo. Uma vez que a instalação tenha sido concluída, você deve ver a seguinte página:

Agora, clique no botão Próximo. Você deve ver a página de login do SuiteCRM:

Forneça seu nome de usuário admin, senha e clique no botão LOG IN. Você deve ver o painel do SuiteCRM na seguinte página:

Proteger o SuiteCRM com Let’s Encrypt

Em seguida, você precisará instalar o pacote cliente Certbot para instalar e gerenciar o SSL Let’s Encrypt.

Primeiro, instale o Certbot com o seguinte comando:

apt-get install certbot python3-certbot-nginx -y

Uma vez que a instalação esteja concluída, execute o seguinte comando para instalar o SSL Let’s Encrypt no seu site:

certbot --nginx -d suitecrm.example.com

Você será solicitado a fornecer um endereço de e-mail válido e aceitar os termos de serviço, conforme mostrado abaixo:

Salvando log de depuração em /var/log/letsencrypt/letsencrypt.log
Plugins selecionados: Autenticador nginx, Instalador nginx
Digite o endereço de e-mail (usado para renovações urgentes e avisos de segurança) (Digite 'c' para cancelar): [email protected]

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Por favor, leia os Termos de Serviço em https://letsencrypt.org/documents/LE-SA-v1.2-November-15-2017.pdf. Você deve concordar para se registrar no servidor ACME em https://acme-v02.api.letsencrypt.org/directory
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
(A)cordo/(C)ancelo: A

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Você estaria disposto a compartilhar seu endereço de e-mail com a Electronic Frontier Foundation, um parceiro fundador do projeto Let's Encrypt e a organização sem fins lucrativos que desenvolve o Certbot? Gostaríamos de enviar e-mails sobre nosso trabalho de criptografia da web, notícias da EFF, campanhas e maneiras de apoiar a liberdade digital.
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
(S)im/(N)ão: Y
Obtendo um novo certificado
Realizando os seguintes desafios:
http-01 desafio para suitecrm.example.com
Aguardando verificação...
Limpando desafios
Implantando Certificado no VirtualHost /etc/nginx/conf.d/suitecrm.conf

Em seguida, escolha se deseja ou não redirecionar o tráfego HTTP para HTTPS, conforme mostrado abaixo:

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
1: Sem redirecionamento - Não faça mais alterações na configuração do servidor web.
2: Redirecionar - Faça todas as solicitações redirecionarem para acesso seguro HTTPS. Escolha isso para novos sites, ou se você tem certeza de que seu site funciona em HTTPS. Você pode desfazer essa alteração editando a configuração do seu servidor web.
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Selecione o número apropriado [1-2] e pressione [enter] (pressione 'c' para cancelar): 2

Digite 2 e pressione Enter para finalizar a instalação. Você deve ver a seguinte saída:

Redirecionando todo o tráfego na porta 80 para ssl em /etc/nginx/conf.d/suitecrm.conf

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Parabéns! Você habilitou com sucesso https://suitecrm.example.com

Você deve testar sua configuração em:
https://www.ssllabs.com/ssltest/analyze.html?d=suitecrm.example.com
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

NOTAS IMPORTANTES:
 - Parabéns! Seu certificado e cadeia foram salvos em:
   /etc/letsencrypt/live/suitecrm.example.com/fullchain.pem
   Seu arquivo de chave foi salvo em:
   /etc/letsencrypt/live/suitecrm.example.com/privkey.pem
   Seu certificado expirará em 2021-10-30. Para obter uma nova versão ou uma versão ajustada
   deste certificado no futuro, basta executar o certbot novamente
   com a opção "certonly". Para renovar *todas* as suas
   certificações de forma não interativa, execute "certbot renew"
 - Suas credenciais de conta foram salvas no diretório de configuração do Certbot em /etc/letsencrypt. Você deve fazer um
   backup seguro desta pasta agora. Este diretório de configuração também conterá certificados e chaves privadas obtidas pelo Certbot, então
   fazer backups regulares desta pasta é ideal.
 - Se você gosta do Certbot, considere apoiar nosso trabalho:

   Doando para ISRG / Let's Encrypt:   https://letsencrypt.org/donate
   Doando para EFF:                    https://eff.org/donate-le

 - Não conseguimos inscrevê-lo na lista de e-mails da EFF porque seu
   endereço de e-mail parece ser inválido. Você pode tentar novamente mais tarde visitando https://act.eff.org.

Agora, seu SuiteCRM está protegido com SSL Let’s Encrypt. Você pode acessá-lo de forma segura usando a URL https://suitecrm.example.com

Conclusão

É isso por agora. Você instalou com sucesso o SuiteCRM com Nginx e SSL Let’s Encrypt no Ubuntu 20.04. Você pode agora implementar o SuiteCRM em sua organização. Para mais informações, visite o manual do usuário do SuiteCRM.