How to install X2CRM on Ubuntu 16.04

How to install X2CRM on Ubuntu 16.04

Today we will show you how to install X2CRM on Ubuntu 16.04, using Apache web-server and MySQL database. X2CRM is an open source marketing, sales, and customer service CRM application powered by an easy to use workflow engine and process management framework. Manage your clients with an endlessly customizable, powerful app, and boost your productivity like never before. It is fairly easy to install X2CRM on an Ubuntu 16.04 VPS. The installation process should take about 5-10 minutes if you follow the very easy steps described below.

At the time of writing this tutorial, X2CRM 6.0.3. is the latest stable version available and it requires:

– Apache web server;
– PHP (version 5.3.2 or higher) along with the mbstring, curl, zip, gd and mcrypt extensions. They are most generally active by default on a standard php installation.
– MySQL(version 5.0.7 or higher) installed on your Linux VPS;

1. Login to your VPS via SSH

ssh user@vps

2. Update the system

[user]$ sudo apt-get update && sudo apt-get -y upgrade

3. Install MariaDB 10.0

To install MariaDB, run the following command:

[user]$ sudo apt-get install -y mariadb-server

4. Create New Database

Next, we need to create a database for our X2CRM installation.

[user]$ mysql -u root -p

MariaDB [(none)]> CREATE DATABASE x2crm;
MariaDB [(none)]> GRANT ALL PRIVILEGES ON x2crm.* TO 'x2crmuser'@'localhost' IDENTIFIED BY 'your-password';
MariaDB [(none)]> FLUSH PRIVILEGES;
MariaDB [(none)]> \q

Do not forget to replace ‘your-password’ with a strong password.

5. Install Apache2 web server

[user]$ sudo apt-get install apache2

6. Install PHP and required PHP modules

To install the latest stable version of PHP version 7 and all necessary modules, run:

[user]$ sudo apt-get install php7.0 libapache2-mod-php7.0 php7.0-mbstring php7.0-curl php7.0-zip php7.0-gd php7.0-mysql php7.0-mcrypt

7. Configure Apache

Enable the Apache2 rewrite module if it is not already done:

[user]$ sudo a2enmod rewrite

In order to activate the new configuration, restart the Apache web server using the following command:

[user]$ sudo service apache2 restart

Download and extract the latest version of X2CRM on your server:

[user]$ sudo cd /opt && wget https://github.com/X2Engine/X2Engine/archive/master.zip
[user]$ sudo unzip master.zip
[user]$ sudo mv X2CRM-master/x2engine/ /var/www/html/x2crm

All files have to be readable by the web server, so we need to set a proper ownership

[user]$ sudo chown www-data:www-data -R /var/www/html/x2crm/

Create a new virtual host directive in Apache. For example, create a new Apache configuration file named ‘x2crm.conf’ on your virtual server:

[user]$ sudo touch /etc/apache2/sites-available/x2crm.conf
[user]$ sudo ln -s /etc/apache2/sites-available/x2crm.conf /etc/apache2/sites-enabled/x2crm.conf
[user]$ sudo nano /etc/apache2/sites-available/x2crm.conf

Then, add the following lines:

<VirtualHost *:80>
ServerAdmin admin@yourdomain.com
DocumentRoot /var/www/html/x2crm/
ServerName your-domain.com
ServerAlias www.your-domain.com
<Directory /var/www/html/x2crm/>
Options FollowSymLinks
AllowOverride All
Order allow,deny
allow from all
</Directory>
ErrorLog /var/log/apache2/your-domain.com-error_log
CustomLog /var/log/apache2/your-domain.com-access_log common
</VirtualHost>

9. Restart Apache

Restart the Apache web server for the changes to take effect:

[user]$ sudo service apache2 restart

9. Continue the Installation in Web Browser

Open your favorite web browser, navigate to http://your-domain.com/ and if you configured everything correctly the X2CRM installer should be starting. You should follow the easy instructions on the install screen inserting the necessary information as requested.

That is it. The X2CRM installation is now complete.

Of course you don’t have to install X2CRM on Ubuntu 16.04, if you use one of our Blazing-Fast VPS Hosting services, in which case you can simply ask our expert Linux admins to install X2CRM for you. They are available 24×7 and will take care of your request immediately.

PS. If you liked this post, on How to install X2CRM on Ubuntu 16.04,  please share it with your friends on the social networks using the buttons on the left or simply leave a reply below. Thanks.

Leave a Comment