In this guide, we’ll discuss the installation of SuiteCRM on CentOS 8 Linux system. SuiteCRM is an open source, enterprise-class CRM application developed and maintained by SalesAgility team. This product was originally forked the SugarCRM Community Edition.

SuiteCRM will help you to manage your business processes, customer data, access to business information, customer interaction, and automate sales for better customer and service delivery experience.

SugarCRM is under active development, and there are many regular functionalities and improvements being added to the core product to make it the best Open Source CRM product. It competes with proprietary CRM vendors such as SugarCRM, Salesforce, and Microsoft.

Install SuiteCRM CentOS 8 – Requirements

  • PHP
  • Nginx web server
  • MySQL / MariaDB database server
  • A user with sudo privileges

Follow the steps below to install and start using SuiteCRM to manage business processes, customer data, access to business information, customer interaction, to automate sales e.t.c.

Step 1: Update System

I recommend you always start work on an updated system:

sudo dnf -y update

Step 2: Install PHP

The first step is to ensure you have the PHP and required extensions are installed in your server.

sudo dnf -y install yum-utils
sudo dnf -y install
sudo dnf -y install
dnf module reset php
sudo dnf module install php:remi-7.3
sudo yum -y install wget php php-{pear,cgi,common,curl,mbstring,gd,mysqlnd,gettext,bcmath,json,xml,fpm,intl,zip,imap}

To confirm the php version installed, use the command php -v

$ php -v
PHP 7.3.13 (cli) (built: Dec 17 2019 10:29:15) ( NTS )
Copyright (c) 1997-2018 The PHP Group
Zend Engine v3.3.13, Copyright (c) 1998-2018 Zend Technologies
     with Zend OPcache v7.3.13, Copyright (c) 1999-2018, by Zend Technologies

Increase php timeout and max file upload size:

$ sudo vim /etc/php.ini
upload_max_filesize = 20M
max_execution_time = 120

Set correct user to run php-fpm service:

$ sudo vim /etc/php-fpm.d/www.conf
user = nginx
group = nginx
listen.mode = 0660

Start and enable php-fpm service:

sudo systemctl enable --now php-fpm

Confirm the service is started without any errors:

$ systemctl status php-fpm
● php-fpm.service - The PHP FastCGI Process Manager
   Loaded: loaded (/usr/lib/systemd/system/php-fpm.service; enabled; vendor preset: disabled)
   Active: active (running) since Sat 2020-01-04 21:07:19 EAT; 39s ago
 Main PID: 1116 (php-fpm)
   Status: "Processes active: 0, idle: 5, Requests: 0, slow: 0, Traffic: 0req/sec"
    Tasks: 6 (limit: 11512)
   Memory: 21.0M
   CGroup: /system.slice/php-fpm.service
           ├─1116 php-fpm: master process (/etc/php-fpm.conf)
           ├─1117 php-fpm: pool www
           ├─1118 php-fpm: pool www
           ├─1119 php-fpm: pool www
           ├─1120 php-fpm: pool www
           └─1121 php-fpm: pool www

Jan 04 21:07:19 centos8.novalocal systemd[1]: Starting The PHP FastCGI Process Manager...
Jan 04 21:07:19 centos8.novalocal systemd[1]: Started The PHP FastCGI Process Manager.

Step 3: Install MariaDB and Nginx Web Server

For this setup, we will use Nginx as a web server for SuiteCRM.

sudo dnf -y install nginx

For database installation refer to out guide:

How to install MariaDB database server on CentOS 8

Once database server has been installed, you need to create a database for SuiteCRM.

$ mysql -u root -p
GRANT ALL ON suitecrm.* TO [email protected] IDENTIFIED by "StrongDBPassword";

Step 4: Install SuiteCRM on CentOS 8

Check SuiteCRM releases page for the latest release. As of this writing, the latest release is v7.11.10.

export VER="7.11.10"
tar xvf v${VER}.tar.gz

Install composer:

wget -O composer-installer.php
sudo php composer-installer.php --filename=composer --install-dir=/usr/local/bin 
composer --version

Run composer install:

cd SuiteCRM-${VER}
composer install

We then need to create a directory for hosting SuiteCRM web data:

cd ..
sudo mkdir /var/www/html/suitecrm
sudo rsync -avv SuiteCRM-${VER}/ /var/www/html/suitecrm

Change ownership of /var/www/html/sduitecrm irectory to the web user:

sudo chown -R nginx:nginx /var/www/html/suitecrm
sudo chmod -R 766 /var/www/html/suitecrm
sudo semanage fcontext -a -t httpd_sys_rw_content_t "/var/www/html/suitecrm(/.*)?"
sudo restorecon -Rv /var/www/html/suitecrm/

Configure Nginx

$ sudo vim /etc/nginx/conf.d/suitecrm.conf 
server {
    client_max_body_size 20M;
    root /var/www/html/suitecrm;
    location / {
       try_files $uri /index.php;
location ~ \.php$ {
    try_files $uri =404;
    fastcgi_pass unix:/var/run/php-fpm/www.sock;
    fastcgi_index index.php;
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    include fastcgi_params;
error_log /var/log/nginx/suitecrm_error.log;
access_log /var/log/nginx/suitecrm_access.log;
location ~ /\.ht {
    deny all;

When done, start nginx and php-fpm service:

sudo systemctl restart nginx php-fpm
sudo systemctl enable nginx php-fpm

Allow http port in the firewall:

sudo firewall-cmd --add-service=http --permanent
sudo firewall-cmd --reload

Step 5: Access SuiteCRM Web Interface

Open your favorite browser and go to

Tick “I Accept” to accept License Agreement terms.

suitecrm install start

Click Next to continue

suitecrm install 02 min

Make sure all checks return OK, then click Next to continue.

On the next page provide:

Configure Database: ( Select Use existing user option)

Database Name: suitcrm_db
Host Name: localhost
User: suitecrm_user
Password: db-user-password

Configure Identify Administration User

SuiteCRM Application Admin Name: Admin
SuiteCRM Admin User Password: Admin-user-password
Re-enter SuiteCRM Admin User Password:

URL of SuiteCRM Instance: URL configured on Nginx

When the installation is done, you should get a login page.

suitecrm install 08

Once done, set up cron for the web user to run SuiteCRM Schedulers,

sudo crontab -e -u nginx

Add the following line to the crontab file:

* * * * * cd /var/www/html/suitecrm; php -f cron.php > /dev/null 2>&1

That’s all. Enjoy using SuiteCRM on Ubuntu 18.04 / CentOS 7 Linux.


Install Dolibarr ERP & CRM on Ubuntu 18.04 LTS

How to Install ERPNext ERP System on Ubuntu 18.04

How To Install Odoo 13 on Ubuntu 18.04 Linux

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