Table of Contents
Was this article helpful?

2  out of  6 found this helpful

Try Vultr Today with

$50 Free on Us!

Want to contribute?

You could earn up to $600 by adding new articles.

How to Install Vtiger CRM Open Source Edition on CentOS 7

Last Updated: Wed, Aug 10, 2016
CentOS Linux Guides System Admin

Vtiger CRM is a popular Customer Relationship Management application which can help enterprises grow sales, deliver customer service, and increase profits.

In this article, I will show you how to install Vtiger CRM open source edition on a Vultr CentOS 7 server instance.


  • A fresh Vultr CentOS 7 server instance.

  • A sudo user. You can learn more details about a sudo user in another Vultr article.

Step 1: Update the system

Log into the system from your SSH terminal as a sudo user, and then update the system using the following commands:

sudo yum update

sudo shutdown -r now

After the system reboot, still use the same sudo user to log in.

Step 2: Install Apache

You can install Apache using YUM:

sudo yum install httpd

Remove the pre-set Apache welcome page:

sudo sed -i 's/^/#&/g' /etc/httpd/conf.d/welcome.conf

For security purposes, you should disallow Apache from displaying files in the web root directory "/var/www/html":

sudo sed -i "s/Options Indexes FollowSymLinks/Options FollowSymLinks/" /etc/httpd/conf/httpd.conf

Start Apache:

sudo systemctl start httpd.service

sudo systemctl enable httpd.service

Step 3: Install PHP and necessary PHP extensions

According to the requirements of installing Vtiger CRM, you need to install PHP 5.4 or above and necessary PHP extensions as below:

sudo yum install php php-common php-gd php-mysql php-xml php-imap php-mbstring php-mcrypt php-gd

Additionally, you need to modify some settings in the PHP config file "/etc/php.ini":

sudo vi /etc/php.ini

Find the following lines, one line at a time:

display_errors = Off

max_execution_time = 30

error_reporting = E_ALL & ~E_DEPRECATED & ~E_STRICT

log_errors = On

short_open_tag = Off

Modify them separately as below:

display_errors = On

max_execution_time = 0

error_reporting = E_WARNING & ~E_NOTICE & ~E_DEPRECATED

log_errors = Off

short_open_tag = On

Save and quit:


In order to put your changes into effect, you need to restart Apache:

sudo systemctl restart httpd.service

Step 4: Install MariaDB and setup a database for Vtiger CRM

Install MariaDB using YUM:

sudo yum install mariadb mariadb-server

Start the MariaDB service:

sudo systemctl start mariadb.service

sudo systemctl enable mariadb.service

Secure the installation of MariaDB:

sudo /usr/bin/mysql_secure_installation

During the process, answer questions as below:

Enter current password for root (enter for none): Enter

Set root password? [Y/n]: Y

New password: <your-password>

Re-enter new password: <your-password>

Remove anonymous users? [Y/n]: Y

Disallow root login remotely? [Y/n]: Y

Remove test database and access to it? [Y/n]: Y

Reload privilege tables now? [Y/n]: Y

Now, let's setup a database for Vtiger CRM:

mysql -u root -p

Type the MariaDB root password you set earlier to log in.

In the MySQL shell, use the following commands to create a database and grant privileges to a database user. Be sure to replace the database name "vtigercrm", the database username "vtigercrmuser", and the database user password "yourpassword" in each and every command with your own ones.

CREATE DATABASE vtigercrm default charset utf8;

CREATE USER 'vtigercrmuser'@'localhost' IDENTIFIED BY 'yourpassword';

GRANT ALL PRIVILEGES ON vtigercrm.* TO 'vtigercrmuser'@'localhost' IDENTIFIED BY 'yourpassword' WITH GRANT OPTION;



Step 5: Install Vtiger CRM

Download the Vtiger CRM archive, unzip it to the web root directory, and setup proper permissions. Note that you can always find the latest URL from Vtiger CRM official website.


wget -O archive.tar.gz

tar -zxvf archive.tar.gz

sudo mv vtigercrm.git/* /var/www/html && sudo chown apache:apache -R /var/www/html

Open port 80 in order to allow outside access:

sudo firewall-cmd --zone=public --permanent --add-service=http

sudo firewall-cmd --reload

Point your browser to the following URL, and continue the job in the Vtiger CRM web installation wizard:


1) On the "Welcome" page, click the "Install" button.

2) On the "License" page, click the "I agree" button.

3) On the "Installation Prerequisites" page, the wizard will show you the result of system check. All of the requirements should have been satisfied if you have performed all of the tasks above. Click the "Next" button.

4) On the "System Configuration" page, you need to input database information, system information, and admin user information.

For this article, the database information should be:

Database Type*    MySQL

Host Name*   localhost

User Name*   vtigercrmuser

Password   yourpassword

Database Name*    vtigercrm

As for system information and admin user information, you need to input your specific info.

After you input all of the mandatory fields, click the "Next" button.

5) On the "Confirm Configuration Settings" page, review your settings and then click the "next" button.

6) On the "One last thing..." page, choose your industry and then click the "Next" button.

7) On the "What would you like to use Vtiger CRM for?" page, select the modules you need, and then click the "Next" button.

8) Now you will enter the interface of Vtiger CRM. Confirm your preferences again and click the "Get Started" button.

That's all. You can explore Vtiger CRM now. Thank you for reading.

Want to contribute?

You could earn up to $600 by adding new articles.