How to Install SuiteCRM on Ubuntu 17.04

Browse By

SuiteCRM is a free and open source alternative of the popular customer relationship management (CRM) system SugarCRM. It became popular when SugarCRM decided to stop development of its open source version. It is an alternative application based on the last SugarCRM Community Edition.

In this tutorial, I will explain how to install SuiteCRM on Ubuntu 17.04.

It is always a good practice to update your OS. You can do this by running the following commands:

sudo apt-get update 
sudo apt-get upgrade 

Once your system has been updated, restart your system and login with a sudo user.

sudo reboot

Install LAMP stack

SuiteCRM is written in PHP, and runs on Apache2, so you will need to install the Apache web server, PHP, and MariaDB to your system.
You can install Apache, PHP, MariaDB along with other required PHP modules by running the following command:

sudo apt-get install apache2 mariadb-server php7.0 php7.0-mysql php7.0-gd php7.0-curl php7-0-imap libapache2-mod-php7.0 php7.0-mcrypt php7.0-xml php7.0-json -y

Update the values for post_max_size, upload_max_filesize, max_input_time, and memory_limit as follows:

sudo nano /etc/php/7.0/cli/php.ini

Change the following lines:

post_max_size = 64M
upload_max_filesize = 64M
max_input_time = 120
memory_limit = 256M

Save and close the file when you are finished, then restart Apache to make these changes take effect:

sudo systemctl restart apache2

Next, enable the IMAP module with the following command:

sudo php5enmod imap

Configure database

Before configuring the database, you will need to secure MariaDB first. You can secure it by running the mysql_secure_installation script:

sudo mysql_secure_installation

Answer all of the questions as shown below:

Set root password? [Y/n] n
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

Once the database is secured, log into the MySQL shell with the following command:

mysql -u root -p

Enter your root password and create a database for SuiteCRM:

MariadDB [(none)]> CREATE DATABASE suitecrm_db;

Create a database user with the following command:

MariaDB [(none)]> CREATE USER 'suitecrm' IDENTIFIED BY 'password';

Grant privileges to the database:

MariaDB [(none)]>GRANT ALL PRIVILEGES ON suitecrm_db.* TO 'suitecrm'@'localhost';

Flush the privileges table with the following command:


Finally, exit from the MySQL shell:

MariaDB [(none)]>\q

Install SuiteCRM

First, download the latest stable version of SuiteCRM from their official website. Once the download has completed, go to the download location and extract the archive with the following command:


Next, move the extracted directory to the apache web root directory:

sudo mv SuiteCRM-7.9.2 /var/www/html/suitecrm

Next, change the permission of the suitecrm directory:

sudo chown -R www-data:www-data /var/www/html/suitecrm
sudo chmod -R 777 /var/www/html/suitecrm

Once you are done, you can proceed to the next step.

Configure Apache for SuiteCRM

Create an Apache virtual host server block for SuiteCRM. You can do this by creating a suitecrm.conf file:

sudo nano /etc/apache2/sites-available/suitecrm.conf

Add the following lines:

<VirtualHost *:80>
 DocumentRoot /var/www/html/suitecrm/
<Directory /var/www/html/suitecrm/>
 Options FollowSymLinks
 AllowOverride All
 ErrorLog /var/log/apache2/suitecrm-error_log
 CustomLog /var/log/apache2/suitecrm-access_log common

Save and close the file when you are finished, then enable the site with the following command:

sudo a2ensite suitecrm

Finally, restart Apache web server so that the changes take place:

sudo systemctl restart apache2

SuiteCRM is ready for use. Open your web browser and navigate to URL and finalize the installation process.

Leave a Reply

Your email address will not be published. Required fields are marked *

+ 87 = 97