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 https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
sudo dnf -y install https://rpms.remirepo.net/enterprise/remi-release-8.rpm
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
wget https://sourceforge.net/projects/vtigercrm/files/vtiger%20CRM%207.2.0/Core%20Product/vtigercrm7.2.0.tar.gz

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]
     ServerName example.com
     ServerAlias www.example.com
     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
  • example.com and www.example.com 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 http://example.com in your browser. The first page to show up will be Installation Wizard.

install vtigercrm centos linux 01

Accept the License Agreement by click “I Agree”

install vtiger crm ubuntu 18.04 welcome page accept license

Confirm all Installation prerequisites checks the click Next button.

install vtiger crm ubuntu 18.04 checks

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

install vtigercrm centos linux 02

Set your Industry type and finish the installation.

install vtiger crm ubuntu 18.04 choose factory

You should be able to check the setup progress.

install vtigercrm centos linux 03

Use the credentials provided during installation to login.

install vtigercrm centos linux 04

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

Your support is our everlasting motivation,
that cup of coffee is what keeps us going!

As we continue to grow, we would wish to reach and impact more people who visit and take advantage of the guides we have on our blog. This is a big task for us and we are so far extremely grateful for the kind people who have shown amazing support for our work over the time we have been online.

Thank You for your support as we work to give you the best of guides and articles. Click below to buy us a coffee.


Please enter your comment!
Please enter your name here