Como Instalar o vTiger CRM no Ubuntu 24.04

vTiger é uma solução de CRM (Gerenciamento de Relacionamento com o Cliente) tudo-em-um para o seu negócio. É adequado para pequenas e médias empresas. O vTiger CRM fornece várias ferramentas para clientes e usuários, que aumentam a operação do seu negócio.

O vTiger CRM oferece duas soluções: a solução em nuvem do vTiger CRM, pela qual você pode pagar por todos os recursos de gerenciamento e adicionais, e a versão de código aberto do vTiger CRM, que você pode hospedar em seu próprio servidor.

Neste guia, vamos orientá-lo na instalação do vTiger CRM em um servidor Ubuntu 24.04. Você instalará e executará o vTiger com a pilha LAMP (Linux, Apache, MySQL/MariaDB e PHP), e então protegerá o vTiger com HTTPS.

Pré-requisitos

Antes de começar, certifique-se de ter o seguinte:

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

Instalando dependências

O vTiger é um software de CRM de código aberto baseado em PHP e MySQL/MariaDB. Você precisa instalar a pilha LAMP ou LEMP em seu sistema para instalá-lo. Neste exemplo, você executará o vTiger com a pilha LAMP em seu sistema Ubuntu.

Primeiro, execute o seguinte comando para atualizar o índice de pacotes do Ubuntu.

sudo apt update

Agora instale os pacotes da pilha LAMP (Linux, Apache2, MySQL/MariaDB e PHP) com o seguinte comando. Digite Y para confirmar a instalação.

sudo apt install apache2 mariadb-server php libapache2-mod-php php-common php-sqlite3 php-json php-curl php-intl php-mbstring php-xmlrpc php-mysql php-gd php-xml php-cli php-zip php-soap php-imap php-bcmath wget unzip -y

Após a instalação ser concluída, verifique o status do servidor web Apache com o seguinte:

sudo systemctl is-enabled apache2
sudo systemctl status apache2

Você pode ver abaixo que o servidor web Apache está habilitado e ativo (em execução).

Verifique o status do serviço MariaDB com o seguinte:

sudo systemctl is-enabled mariadb
sudo systemctl status mariadb

Você verá o status do servidor MariaDB ativo (em execução) e habilitado.

Por fim, verifique a versão do PHP usando o comando abaixo. O PHP 8.3 deve estar instalado em seu sistema Ubuntu.

sudo php -v

Configurando o PHP

Após instalar as dependências, você configurará a instalação do PHP editando o arquivo de configuração php.ini.

Abra a configuração padrão do PHP /etc/php/8.3/apache2/php.ini com o seguinte editor nano.

sudo nano /etc/php/8.3/apache2/php.ini

Altere as configurações padrão como a seguir - certifique-se de ajustar as opções memory_limit e date.timezone conforme necessário.

memory_limit = 512M
upload_max_file_size = 100M
log_errors = Off
max_execution_time = 100
date.timezone = Europe/Amsterdam

Quando terminar, salve o arquivo e saia do editor.

Agora execute o seguinte comando para reiniciar o servidor web Apache e aplicar sua configuração PHP.

sudo systemctl restart apache2

Configurando o servidor MariaDB

Nesta seção, você protegerá a instalação do servidor MariaDB. Em seguida, um novo banco de dados e usuário serão criados que o vTiger CRM usará. Você usará mariadb-secure-installation para proteger o MariaDB e o cliente mariadb para criar um novo banco de dados e usuário.

Para configurar o servidor MariaDB, abra o arquivo /etc/mysql/maridb.conf.d/50-server.conf com o seguinte comando do editor nano.

sudo nano /etc/mysql/maridb.conf.d/50-server.conf

Na seção [mysqld], adicione a seguinte linha:

sql_mode = ""

Salve o arquivo e saia do editor.

Agora execute o comando abaixo para reiniciar o servidor MariaDB e aplicar suas alterações.

sudo systemctl status mariadb

Em seguida, você precisará proteger a instalação do MariaDB com a utilidade mariadb-secure-installation. Execute-a como a seguir:

sudo mariadb-secure-installation

Você será questionado sobre as seguintes configurações:

• pressione enter para confirmar e configurar a implantação do MariaDB.
• Digite Y para alterar o método de autenticação para unix_socket.
• Digite Y para configurar a senha root para o MariaDB e digite a nova senha forte.
• Digite Y para remover o usuário anônimo padrão do servidor MariaDB.
• Para desabilitar o login remoto para o usuário root, digite Y novamente para confirmar.
• Agora remova o banco de dados de teste padrão do servidor MariaDB.
• Por fim, digite Y novamente para recarregar todos os privilégios de tabela.

Agora que você protegeu o servidor MariaDB, criará um novo banco de dados e usuário que o vTiger CRM usará. Faça login no servidor MariaDB com o comando mariadb abaixo.

Digite sua senha root do MariaDB quando solicitado.

sudo mariadb -u root -p

Execute as seguintes consultas para criar um novo banco de dados e usuário para o vTiger. Neste exemplo, você criará um novo banco de dados vtigerdb e um novo usuário vtiger com a senha password.

CREATE DATABASE vtigerdb;
CREATE USER vtiger@localhost IDENTIFIED BY ‘password’;
GRANT ALL ON vtigerdb.* TO vtiger@localhost WITH GRANT OPTION;
FLUSH PRIVILEGES;

Agora execute a consulta abaixo para verificar os privilégios do usuário vtiger. Certifique-se de que o usuário vtiger pode acessar o banco de dados vtigerdb.

SHOW GRANT FOR vtiger@localhost;

Digite quit para sair do servidor MariaDB.

Baixando o código-fonte do vTiger

Agora que você configurou tanto o PHP quanto o MariaDB, você baixará o código-fonte do vTiger e configurará o diretório raiz do documento com as permissões e propriedade adequadas.

Vá para o diretório /var/www e baixe o código-fonte do vTiger com o comando wget abaixo. Visite a página de download do vTiger CRM para pegar o link para a versão mais recente.

cd /var/www/
wget https://sourceforge.net/projects/vtigercrm/files/vtiger CRM 8.2.0/Core Product/vtigercrm8.2.0.tar.gz/download

Agora execute o comando abaixo para extrair o código-fonte do vTiger. Com isso, seu diretório raiz do documento para o vTiger deve estar localizado no diretório /var/www/vtiger.

tar -xf download

Por fim, altere a propriedade do diretório /var/www/vtigercrm para o usuário www-data e a permissão padrão para 0755.

sudo chown -R www-data:www-data /var/www/vtigercrm
sudo chmod 755 /var/www/vtigercrm

Adicionando host virtual do Apache

Após baixar o código-fonte do vTiger, você criará um novo host virtual do Apache para executar o vTiger. Certifique-se de ter seu nome de domínio pronto e apontado para o endereço IP do seu servidor.

Primeiro, execute o comando abaixo para habilitar os módulos rewrite e headers no servidor web Apache.

sudo a2enmod rewrite headers

Crie uma nova configuração de host virtual /etc/apache2/sites-available/vtiger.conf com o comando nano abaixo.

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

Adicione a configuração abaixo e certifique-se de alterar o nome do domínio para o seu domínio.

    ServerName crm.howtoforge.local
    DocumentRoot /var/www/vtigercrm

     
        Options +FollowSymlinks
        AllowOverride All
        Require all granted
     

     ErrorLog /var/log/apache2/vtigercrm_error.log
     CustomLog /var/log/apache2/vtigercrm_access.log combined

Quando terminar, salve e saia do arquivo.

Agora execute o comando abaixo para ativar o arquivo de host virtual vtiger.conf e verificar sua sintaxe do Apache. Se você tiver a sintaxe do Apache correta, receberá uma saída Syntax is OK.

sudo a2ensite vtiger.conf
sudo apachectl configtest

Por fim, reinicie o servidor web Apache para aplicar suas alterações com o seguinte - Com isso, sua instalação do vTiger está pronta.

sudo systemctl restart apache2

Protegendo o vTiger com HTTPS

Para proteger o vTiger, você configurará HTTPS através do Certbot e Letsencrypt. Com isso, você pode gerar certificados SSL/TLS e configurar HTTPS automaticamente em seu host virtual Apache.

Instale o certbot e o plugin python3-certbot-apache com o seguinte comando. Digite Y para confirmar a instalação.

sudo apt install certbot python3-certbot-apache

Após a instalação ser concluída, gere novos certificados SSL/TLS para o seu nome de domínio do vTiger com o seguinte. Certifique-se de alterar tanto seu endereço de e-mail quanto o nome do domínio com suas informações.

sudo certbot –apache –agree-tos –redirect –hsts –staple-ocsp –email [email protected] -d crm.howtoforge.local

Quando o processo estiver completo, seus certificados SSL/TLS estarão disponíveis no diretório /etc/letsencrypt//live/domain.com. E sua instalação do vTiger estará protegida com HTTPS.

Instalando o vTiger CRM

Visite o nome de domínio da sua instalação do vTiger, como https://crm.howtoforge.local/; você verá o assistente de instalação do vTiger.

Clique em Instalar para iniciar a instalação.

Clique em Eu Concordo para confirmar a licença e os termos do vTiger CRM.

Agora, certifique-se de que seu sistema está pronto para a instalação do vTiger CRM. Certifique-se de que o status de todos os requisitos é Sim, e clique em Próximo.

Insira os detalhes do nome do banco de dados MariaDB, usuário e senha. Em seguida, insira um novo usuário administrador para a instalação do vTiger. Clique em Próximo para confirmar.

Verifique novamente os detalhes da instalação do vTiger CRM e clique em Próximo.

Deixe a seção de coleta de dados anônimos como padrão e clique em Próximo.

Agora, a instalação do vTiger CRM começará.

Quando a instalação estiver completa, selecione os módulos conforme necessário e clique em Próximo para continuar.

Agora você será redirecionado para o painel do vTiger CRM como o seguinte:

Nas configurações de administração do vTiger, você pode ver informações detalhadas relacionadas à sua instalação e configuração do vTiger CRM.

Conclusão

Parabéns! Você completou a instalação do vTiger CRM no servidor Ubuntu 24.04. Você tem o vTiger CRM funcionando com a pilha LAMP (Linux, Apache, MySQL/MariaDB e PHP) e protegido com HTTPS através do Certbot e Letsencrypt.