How to install vTiger CRM on CentOS 8 Linux

Let’s see how to install vTiger CRM on CentOS 8 Linux distribution. Vtiger is an open source CRM that includes inventory, email, project management, and other tools that provide a complete business management suite. This will ensure you provide quality support, sales management, and enable marketing teams to work smoothly to drive business growth and increase customer satisfaction.

vTiger CRM Features

Some key features of vTiger CRM include, but are not limited to:

  • Support automation using customer portal and support tickets
  • With role-based access control
  • Provide end-to-end sales cycle management of activities, leads, potential, quotes, invoices.
  • Provides you with Outlook, Thunderbird, Firefox and Gmail plugins
  • Workflow, task and project management
  • Supports data import and export via CSV files, web to lead form, reports and customizable user dashboards

The vTiger CRM we installed on CentOS 8 will require Apache web server, PHP and MariaDB database server. Here are the steps to get you started.

Step 1: Install PHP on CentOS 8

Install PHP and its extensions by running the following command on a terminal:

sudo dnf -y install yum-utils
sudo dnf -y install
sudo dnf -y install
sudo dnf module reset php
sudo dnf module -y install php:remi-7.2
sudo yum -y install vim php php-{pear,cli,cgi,common,curl,mbstring,gd,mysqlnd,gettext,bcmath,json,xml,fpm,intl,zip,imap,ldap,soap,xmlrpc}

Configure the PHP settings as follows:

sudo vim /etc/php.ini


date.timezone = Africa/Nairobi
memory_limit = 256M
upload_max_filesize = 64M
display_errors = On
log_errors = Off

Step 2: Install MariaDB and create database

vTiger CRM requires a database for its data storage. Install MariaDB using the following guidelines:

Install MariaDB on CentOS 8

Set SQL mode

$ sudo vim /etc/my.cnf.d/server.cnf

Restart mysql service

sudo systemctl restart mariadb

After installing the database server, log in to MySQL Shell as the root user and create a database for vTiger CRM.

Log in to the MariaDB shell:

$ mysql -u root -p

Create database and user for vTiger CRM:

CREATE USER 'vtiger'@'localhost' IDENTIFIED BY 'StrongPassword';
CREATE DATABASE vtiger CHARACTER SET utf8 COLLATE utf8_general_ci;
GRANT ALL PRIVILEGES ON vtiger.* TO 'vtiger'@'localhost';

Check if you can log in to the database shell as vtiger user:

$ mysql -u vtiger -p
 Enter password: 
 Welcome to the MariaDB monitor.  Commands end with ; or g.
 Your MariaDB connection id is 19
 Server version: 10.4.11-MariaDB MariaDB Server
 Copyright (c) 2000, 2018, Oracle, MariaDB Corporation Ab and others.
 Type 'help;' or 'h' for help. Type 'c' to clear the current input statement.
 MariaDB [(none)]> SHOW DATABASES;
 | Database           |
 | information_schema |
 | vtiger             |
 2 rows in set (0.000 sec)
 MariaDB [(none)]> QUIT

Step 3: Download Vtiger on CentOS 8 Linux

The next step is to download the latest Vtiger latest version to CentOS 8 system using the following tools. wgetcommand:

sudo dnf -y install wget

Extract the archive to get the files:

tar xvf vtigercrm7.2.0.tar.gz

Install Apache httpd server:

sudo dnf -y install httpd

Move vtigercrm The folder and its contents go to / var / www / html.

sudo mv vtigercrm /var/www/html/

Step 4: Configure Apache

Then set the appropriate directory permissions.

sudo chown -R apache:apache /var/www/html/vtigercrm

Then create a virtual host file for vTiger:

sudo vim /etc/httpd/conf.d/vtigercrm.conf

adding data:

     ServerAdmin [email protected]com
     DocumentRoot /var/www/html/vtigercrm/

        Options +FollowSymlinks
        AllowOverride All
        Require all granted

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


  • [email protected] Is the email address of the server administrator
  • with Is a valid DNS name for Vtiger CRM

Verify file syntax:

$ sudo apachectl -t
Syntax OK

Restart httpd service:

sudo systemctl restart httpd

Open the http port in the firewall.

sudo firewall-cmd --add-service=http --permanent
sudo firewall-cmd --reload

Disable SELinux:

sudo setenforce 0
sudo sed -i 's/^SELINUX=.*/SELINUX=disabled/g' /etc/selinux/config

Complete installation by opening In your browser. The first page displayed will be the installation wizard.

Click “Accept License Agreement”I agree”

How to install vTiger CRM on CentOS 8 Linux

Confirm all installation prerequisites check Click next Button.

How to install vTiger CRM on CentOS 8 Linux

Under system configuration:

1. Provide database and system information.

  • Database type: MySQL
  • CPU name: local host
  • username: vtiger
  • Password: Strong password
  • Name database: vtiger

2. Provide system information

  • Provide admin user password
  • Provide last name
  • Provide email address of admin user
  • Set date format and time zone

Confirm the settings and click next

How to install vTiger CRM on CentOS 8 Linux

Set your industry type and complete the installation.

How to install vTiger CRM on CentOS 8 Linux

You should be able to check the progress of the setup.

How to install vTiger CRM on CentOS 8 Linux

Log in using the credentials provided during the installation.

How to install vTiger CRM on CentOS 8 Linux

Complete the installation and log in to the dashboard to start managing vTiger CRM. Check official vTiger documentation For comprehensive usage guidelines.

More related content.

Install Mautic Marketing & CRM software on CentOS 7

How to install Odoo 13 on Ubuntu 18.04 Linux

How to install ERPNext ERP system on Ubuntu

Install Dolibarr ERP & CRM on Ubuntu 18.04 LTS