{"id":6109,"date":"2020-06-12T08:07:10","date_gmt":"2020-06-12T05:07:10","guid":{"rendered":"https:\/\/kifarunix.com\/?p=6109"},"modified":"2024-03-14T21:20:47","modified_gmt":"2024-03-14T18:20:47","slug":"install-and-setup-vtiger-crm-on-ubuntu-20-04","status":"publish","type":"post","link":"https:\/\/kifarunix.com\/install-and-setup-vtiger-crm-on-ubuntu-20-04\/","title":{"rendered":"Install and Setup Vtiger CRM on Ubuntu 20.04"},"content":{"rendered":"\n

In this tutorial, we are going to learn how to install and setup Vtiger CRM on Ubuntu 20.04. CRM is an abbreviation for Custom Relationship Management. Vtiger CRM<\/a> enables sales, support, and marketing teams to organize and collaborate to measurably improve customer experiences and business outcomes. In this tutorial, we are going to install the opensource version of Vtiger on Ubuntu 20.04.<\/p>\n\n\n\n

Installing Vtiger CRM on Ubuntu 20.04<\/h2>\n\n\n\n

Prerequisites<\/h3>\n\n\n\n

System Requirements<\/h4>\n\n\n\n

Ensure that you have at least 2 CPU cores, at least 4GB RAM and enough disk space. (Vtiger recommends 250G for attachments)<\/p>\n\n\n\n

Install and Setup LAMP Stack<\/h4>\n\n\n\n

Vtiger is a PHP based web application. As such, ensure that you install and setup LAMP stack before you can proceed. We have covered the installation and setup of LAMP stack on Ubuntu 20.04 in our previous guide. You can follow the link below to setup LAMP stack.<\/p>\n\n\n\n

Install LAMP Stack on Ubuntu 20.04<\/a><\/p>\n\n\n\n

Install other required PHP modules;<\/p>\n\n\n\n

apt install php php-imap php-curl php-xml php-mysql php-mbstring<\/code><\/pre>\n\n\n\n
Configure PHP for Vtiger<\/h4>\n\n\n\n
Open the \/etc\/php\/7.4\/apache2\/php.ini<\/strong><\/code> configuration file and make the following adjustments;<\/p>\n\n\n\n
vim \/etc\/php\/7.4\/apache2\/php.ini<\/code><\/pre>\n\n\n\n
memory_limit = 256M<\/code><\/pre>\n\n\n\n
max_execution_time = 60<\/code><\/pre>\n\n\n\n
log_errors = Off<\/code><\/pre>\n\n\n\n
display_errors = Off<\/code><\/pre>\n\n\n\n
short_open_tag = Off<\/code><\/pre>\n\n\n\n
Save and exit the file.<\/p>\n\n\n\n
Create Database and Database User for Vtiger<\/h3>\n\n\n\n
Next, once the LAMP stack is in place, login to MySQL as administrative user.<\/p>\n\n\n\n
mysql -u root -p<\/code><\/pre>\n\n\n\n
Note that we are using MySQL 8 in this tutorial.<\/p>\n\n\n\n
mysql -V<\/code><\/pre>\n\n\n\n
mysql Ver 8.0.20-0ubuntu0.20.04.1 for Linux on x86_64 ((Ubuntu))<\/code><\/pre>\n\n\n\n
Create Vtiger database and database user. Be sure to replace the usernames.<\/p>\n\n\n\n
create database vtiger default character set utf8 default collate utf8_general_ci;<\/code><\/pre>\n\n\n\n
create user vtigeradm@localhost identified by 'myStr0nGp@ss';<\/code><\/pre>\n\n\n\n
Grant all privileges to Vtiger database use on the Vtiger database.<\/p>\n\n\n\n
grant all on vtiger.* to vtigeradm@localhost;<\/code><\/pre>\n\n\n\n
Reload the privileges table and exit the database;<\/p>\n\n\n\n
flush privileges;<\/code><\/pre>\n\n\n\n
exit;<\/code><\/pre>\n\n\n\n
Next, implement the following global configuration for MySQL;<\/p>\n\n\n\n
echo -e '[mysqld]\\nsql_mode = \"\"' >> \/etc\/mysql\/my.cnf<\/code><\/pre>\n\n\n\n
Restart MySQL;<\/p>\n\n\n\n
systemctl restart mysql<\/code><\/pre>\n\n\n\n
Download Vtiger Application Tarball<\/h3>\n\n\n\n
Navigate to Vtiger downloads page<\/a> and the latest tarball for the opensource version of Vtiger.<\/p>\n\n\n\n
wget https:\/\/sourceforge.net\/projects\/vtigercrm\/files\/vtiger%20CRM%207.2.0\/Core%20Product\/vtigercrm7.2.0.tar.gz<\/code><\/pre>\n\n\n\n
Extract and Install Vtiger CRM on Ubuntu 20.04<\/h3>\n\n\n\n
Once the download is complete, extract the tarball to your preferred web root directory. Note the Vtiger is a ready to deploy application.<\/p>\n\n\n\n
In this demo, we will use \/var\/www\/vtigercrm<\/strong><\/code> as our default Vtiger CRM web root directory.<\/p>\n\n\n\n
mkdir \/var\/www\/vtigercrm<\/code><\/pre>\n\n\n\n
tar xzf vtigercrm7.2.0.tar.gz --strip-components=1 -C \/var\/www\/vtigercrm\/<\/code><\/pre>\n\n\n\n
Create Apache Web Configuration for Vtiger CRM<\/h3>\n\n\n\n
Since we are using Apache as our web server for the Vtiger CRM, you need to create the web configuration file to define how to access Vtiger from web as follows;<\/p>\n\n\n\n
vim \/etc\/apache2\/sites-available\/vtigercrm.conf<\/code><\/pre>\n\n\n\n
Paster the following configurations making changes as per your setup.<\/p>\n\n\n\n
<VirtualHost *:80>\n     ServerName vtigercrm.kifarunix-demo.com\n     DocumentRoot \/var\/www\/vtigercrm\/\n\n     <Directory \/var\/www\/vtigercrm\/>\n        Options FollowSymlinks\n        AllowOverride All\n        Require all granted\n     <\/Directory>\n\n     ErrorLog \/var\/log\/apache2\/vtigercrm_error.log\n     CustomLog \/var\/log\/apache2\/vtigercrm_access.log combined\n<\/VirtualHost><\/code><\/pre>\n\n\n\n
If you want, you can configure Vtiger CRM with SSL\/TLS cerfiticates.<\/p>\n\n\n\n
Set the ownership of the Vtiger CRM web root directory to Apache user;<\/p>\n\n\n\n
chown -R www-data:www-data \/var\/www\/vtigercrm\/<\/code><\/pre>\n\n\n\n
Save and exit the configuration file above.<\/p>\n\n\n\n
Disable default Apache site;<\/p>\n\n\n\n
a2dissite 000-default.conf<\/code><\/pre>\n\n\n\n
Enable Vtiger CRM Apache site;<\/p>\n\n\n\n
a2ensite vtigercrm.conf<\/code><\/pre>\n\n\n\n
Enable Apache Rewrite Module;<\/p>\n\n\n\n
a2enmod rewrite<\/code><\/pre>\n\n\n\n
Check Apache configuration syntax;<\/p>\n\n\n\n
apachectl -t<\/code><\/pre>\n\n\n\n
If you get Syntax OK<\/code><\/strong>, proceed to restart Apache.<\/p>\n\n\n\n
systemctl restart apache2<\/code><\/pre>\n\n\n\n
Finalize Vtiger CRM Setup from Browser<\/h3>\n\n\n\n
Open Apache on UFW to allow external access;<\/p>\n\n\n\n
ufw allow 80\/tcp<\/code><\/pre>\n\n\n\n
You can then access it via the address, http:\/\/server-IP-or-hostname<\/strong>.<\/p>\n\n\n\n
On the welcome page, click Install<\/code><\/strong> button to go through the setup wizard.<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
On the next page, accept the EULA and proceed.<\/p>\n\n\n\n
On the Installation prerequisites, ensure that all pre-reqs are met. Otherwise fix them before you proceed.<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
On system configuration page, configure database connection details as defined above and setup your Vtiger CRM administrative account.<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Click Next to review the system configuration settings.<\/p>\n\n\n\n
On the Next<\/strong> page, select your Industry and click Next to proceed with installation.<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Wait for the installation to complete. This might take some time<\/strong>.<\/p>\n\n\n\n
Once the installation is done, Select the modules for the Vtiger features you would like to have.<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Click Next and login to you Vtiger. Use the administrative credentials you set above.<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
You can now add more widgets to your dashboard.<\/p>\n\n\n\n
Great. That is all on how to installing Vtiger CRM on Ubuntu 20.04. You can configure it further to your liking. Enjoy.<\/p>\n\n\n\n
Further Reading<\/h3>\n\n\n\n
Vtiger Documentation<\/a><\/p>\n\n\n\n
Reference<\/h3>\n\n\n\n
Installation – Vtiger<\/a><\/p>\n\n\n\n
Other Tutorials<\/h3>\n\n\n\n
Configure Offline Authentication via OpenLDAP on MacOS X<\/a><\/p>\n\n\n\n
Configure OpenLDAP Authentication on MacOS X<\/a><\/p>\n\n\n\n
Install and Deploy Kubernetes Cluster on Ubuntu 20.04<\/a><\/p>\n\n\n\n
Configure Highly Available HAProxy with Keepalived on Ubuntu 20.04<\/a><\/p>\n\n\n\n
Install and Setup HAProxy on Ubuntu 20.04<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"
In this tutorial, we are going to learn how to install and setup Vtiger CRM on Ubuntu 20.04. CRM is an abbreviation for Custom Relationship<\/p>\n","protected":false},"author":3,"featured_media":9119,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"rank_math_lock_modified_date":false,"footnotes":""},"categories":[121,1686],"tags":[1691,1689,1687,1690,1200,1688],"class_list":["post-6109","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-howtos","category-crm","tag-configure-vtiger-on-ubuntu","tag-crm","tag-install-vtiger-crm-on-ubuntu-20-04","tag-setup-vtiger-on-ubuntu-20-04","tag-ubuntu-20-04","tag-vtiger","generate-columns","tablet-grid-50","mobile-grid-100","grid-parent","grid-50","resize-featured-image"],"_links":{"self":[{"href":"https:\/\/kifarunix.com\/wp-json\/wp\/v2\/posts\/6109"}],"collection":[{"href":"https:\/\/kifarunix.com\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/kifarunix.com\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/kifarunix.com\/wp-json\/wp\/v2\/users\/3"}],"replies":[{"embeddable":true,"href":"https:\/\/kifarunix.com\/wp-json\/wp\/v2\/comments?post=6109"}],"version-history":[{"count":8,"href":"https:\/\/kifarunix.com\/wp-json\/wp\/v2\/posts\/6109\/revisions"}],"predecessor-version":[{"id":21426,"href":"https:\/\/kifarunix.com\/wp-json\/wp\/v2\/posts\/6109\/revisions\/21426"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/kifarunix.com\/wp-json\/wp\/v2\/media\/9119"}],"wp:attachment":[{"href":"https:\/\/kifarunix.com\/wp-json\/wp\/v2\/media?parent=6109"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/kifarunix.com\/wp-json\/wp\/v2\/categories?post=6109"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/kifarunix.com\/wp-json\/wp\/v2\/tags?post=6109"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}