You can support us by downloading this article as PDF from the Link below. Download the guide as PDF

Let’s look at how to Install vTiger CRM on CentOS 8 Linux distribution. Vtiger is an open source CRM which includes inventory, email, project management, and other tools that provides a complete business management suite. This will ensure you offer premium support, sales management and for marketing teams to work smoothly to boost business growth and improve customer delight.

Features of vTiger CRM

Some top features of vTiger CRM include but not limited to:

  • Support automation using a customer portal and support tickets
  • Has a role-based access control
  • Provides End to end sales cycle management from campaigns, leads, potentials, quotes, invoices.
  • Gives you Outlook, Thunderbird, Firefox, & Gmail plugins
  • Workflows, tasks, and project management
  • Support Data import & export via CSV files, web-to-lead forms, reports & customizable user dashboards

Our installation of vTiger CRM 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 commands below on your 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 PHP settings like below:

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 needs a database store for its data. Install MariaDB by using the guide below:

Install MariaDB on CentOS 8

Set SQL Mode

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

Restart mysql service

sudo systemctl restart mariadb

After the database server is installed, login to MySQL shell as root user and create a Database for vTiger CRM.

Login to the MariaDB shell:

$ mysql -u root -p

Create a 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 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 your CentOS 8 system using the 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 folder and its contents to /var/www/html.

sudo mv vtigercrm /var/www/html/

Step 4: Configure Apache

Then set proper 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

Add data:

<VirtualHost *:80>
     ServerAdmin [email protected]
     DocumentRoot /var/www/html/vtigercrm/

     <Directory /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 server admin email address
  • and are valid DNS names for Vtiger CRM

Verify file syntax:

$ sudo apachectl -t
Syntax OK

Restart httpd service:

sudo systemctl restart httpd

Open 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

Finish the installation by opening in your browser. The first page to show up will be Installation Wizard.

Accept the License Agreement by click “I Agree”

Confirm all Installation prerequisites checks the click Next button.

Under System Configuration:

1. Provide Database and System Information.

  • Database Type: MySQL
  • Host Name: localhost
  • User Name: vtiger
  • Password: StrongPassword
  • Database Name: vtiger

2. Provide System Information

  • Provide admin user Password
  • Provide the Last Name
  • Provide an Email address for the admin user
  • Set Date format and Timezone

Confirm settings then click Next

Set your Industry type and finish the installation.

You should be able to check the setup progress.

Use the credentials provided during installation to login.

Finish the installation and login to the dashboard to start administering vTiger CRM. Check the official vTiger documentation for comprehensive usage guide.

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

You can support us by downloading this article as PDF from the Link below. Download the guide as PDF