- \n
- Install Nginx Web server<\/li>\n
- Install and Configure PHP-FPM<\/li>\n
- Install and Configure MariaDB<\/li>\n
- Download and Configure SuiteCRM<\/li>\n
- SuiteCRM Web Installer<\/li>\n
- Final steps<\/li>\n<\/ol>\n
Prerequisites<\/h2>\n
- \n
- Ubuntu 16.04 Server<\/li>\n
- Root privileges<\/li>\n<\/ul>\n
Step 1 – Install Nginx Web server<\/h2>\n
SuiteCRM is a web based software, and it needs a web server. We can use Apache or Nginx for this software. In this tutorial, we will be using the Nginx web server instead of the Apache web server.<\/p>\n
Connect to your Ubuntu server and update the repository.<\/p>\n
ssh [email\u00a0protected]<\/a>
sudo apt update<\/p>\nNow install the Nginx web server using the apt command in the following way.<\/p>\n
apt install -y nginx<\/p>\n
After the installation, start nginx and enable it to launch automatically every time at system boot.<\/p>\n
systemctl start nginx
systemctl enable nginx<\/p>\nThe Nginx web server is installed, and it’s running under the default HTTP port 80. Check it using the netstat command, or you can use curl to see the HTTP status code.<\/p>\n
netstat -plntu
curl -I localhost<\/p>\n![\"Install](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/02\/how-to-install-suitecrm-with-nginx-on-ubuntu-16-04.png\" "\\"\\"")
<\/a><\/p>\nStep 2 – Install and Configure PHP-FPM<\/h2>\n
SuiteCRM is compatible with multiple PHP versions. In this tutorial, we will be using the newest version PHP 7.0 for SuiteCRM installation.<\/p>\n
Install PHP and PHP-FPM 7 along with other required extensions using the following apt command.<\/p>\n
apt install -y php7.0-fpm php7.0-mcrypt php7.0-imap php7.0-curl php7.0-cli php7.0-mysql php7.0-gd php7.0-xsl php7.0-json php7.0-intl php-pear php7.0-dev php7.0-common php7.0-mbstring php7.0-zip php-soap libcurl3 curl<\/p>\n
After the installation is complete, go to the PHP configuration directory and edit php.ini files for both ‘cli’ and ‘fpm’ configuration.<\/p>\n
cd \/etc\/php\/7.0\/<\/p>\n
Edit php.ini files.<\/p>\n
vim cli\/php.ini
vim fpm\/php.ini<\/p>\nChange the max upload file size value. SuiteCRM needs at least 6MB, but we’ll set 100MB as the value.<\/p>\n
upload_max_filesize = 100M<\/pre>\n
Uncomment the CGI line (shown below) and change the value to 0.<\/p>\n
cgi.fix_pathinfo=0<\/pre>\n
For the sessions path configuration, uncomment the line below.<\/p>\n
session.save_path = \"\/var\/lib\/php\/sessions\"<\/pre>\n
That’s it. Save these changes and exit.<\/p>\n
Now, we need to create a new directory for PHP sessions files and change the owner of the directory to ‘www-data’ user and group.<\/p>\n
mkdir -p \/var\/lib\/php\/sessions
chown -R www-data:www-data \/var\/lib\/php\/sessions<\/p>\nPHP and PHP-FPM configuration has been completed. Now start the service and enable it to launch every time at system boot.<\/p>\n
systemctl start php7.0-fpm
systemctl enable php7.0-fpm<\/p>\nBy default on the Ubuntu system, PHP-FPM will run under the sock file instead of using system port. Check it using the netstat command below.<\/p>\n
netstat -pl | grep php<\/p>\n
And make sure the result you see is similar to what’s shown in the following screenshot.<\/p>\n
![\"Install](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/02\/how-to-install-suitecrm-with-nginx-on-ubuntu-16-04-1.png\" "\\"\\"")
<\/a><\/p>\nStep 3 – Install and Configure MariaDB<\/h2>\n
In this step, we will install MariaDB and configure the root password. Then configure a new database for SuiteCRM installation.<\/p>\n
Install MariaDB using the apt command below.<\/p>\n
apt install -y mariadb-server mariadb-client<\/p>\n
After the installation, start the service and enable it to launch every time at system boot.<\/p>\n
systemctl start mysql
systemctl enable mysql<\/p>\nNext, configure the MariaDB root password using the ‘mysql_secure_installation’ command as below.<\/p>\n
mysql_secure_installation<\/p>\n
You will be asked about the configuration, type ‘Y’ and press ‘Enter’.<\/p>\n
Set root password? [Y\/n] Y
Remove anonymous users? [Y\/n] Y
MariaDB root password has been configured.<\/p>\n
Now we will create a new database and user for SuiteCRM installation. Create a database named ‘suitecrm_db’, and a new user ‘crmadmin’ with password ‘hakase-labs123’. Connect to the mysql shell and run the following mysql queries.<\/p>\n
mysql -u root -p
Type your password:<\/p>\nCREATE DATABASE suitecrm_db;
CREATE USER ‘crmadmin’@’localhost’ IDENTIFIED BY ‘hakase-labs123’;
GRANT ALL PRIVILEGES ON suitecrm_db.* TO ‘crmadmin’@’localhost’;
FLUSH PRIVILEGES;<\/p>\n![\"Install](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/02\/how-to-install-suitecrm-with-nginx-on-ubuntu-16-04-2.png\" "\\"\\"")
<\/a><\/p>\nMariaDB database configuration for SuiteCRM installation has been completed.<\/p>\n
Step 4 – Download and Configure SuiteCRM<\/h2>\n
In this step, we will do some tasks that’ll prepare the system for SuiteCRM installation. We will download the SuiteCRM source code, configure UFW Firewall, generate Letsencrypt certificates, and configure nginx virtual host for SuiteCRM.<\/p>\n
– Download SuiteCRM Source Code<\/strong><\/p>\n
The suiteCRM source code is available on Github. Make sure the git command installed on your system. Or if you do not have a git package, install it with the apt command below.<\/p>\n
apt install -y git<\/p>\n
Now go to the ‘\/opt’ directory and clone the repository using the following git clone command.<\/p>\n
cd \/opt\/
git clone https:\/\/github.com\/salesagility\/SuiteCRM.git suitecrm<\/p>\nGo to the suitecrm directory and create a new ‘cache’ directory. Then change the permission of some files and directories, and finally, we need to change the ownership permissions for the ‘suitecrm’ directory to ‘www-data’ user and group.<\/p>\n
cd \/opt\/suitecrm
mkdir -p \/opt\/suitecrm\/cache
chmod -R 775 cache custom modules themes data upload config_override.php
chown www-data:www-data -R \/opt\/suitecrm<\/p>\n![\"Download](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/02\/how-to-install-suitecrm-with-nginx-on-ubuntu-16-04-3.png\" "\\"\\"")
<\/a><\/p>\nSuiteCRM source code has been downloaded.<\/p>\n
– Configure UFW Firewall<\/strong><\/p>\n
On Ubuntu, we will be using the ufw firewall. Open new ports HTTP, HTTPS, and SSH using the ufw commands as shown below.<\/p>\n
ufw allow ssh
ufw allow http
ufw allow https<\/p>\nNow start the firewall and enable it to launch every time at system boot using ufw enable command.<\/p>\n
ufw enable<\/p>\n
Type ‘y’ and press Enter to enable the firewall.<\/p>\n
![\"Configure](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/02\/how-to-install-suitecrm-with-nginx-on-ubuntu-16-04-4.png\" "\\"\\"")
<\/a><\/p>\nIf you want to check the firewall status, use the ufw status command.<\/p>\n
ufw status<\/p>\n
And you will get the firewall status including what ports you have added.<\/p>\n
![\"Firewall](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/02\/how-to-install-suitecrm-with-nginx-on-ubuntu-16-04-5.png\" "\\"\\"")
<\/a><\/p>\n– Generate Letsencrypt Certificates<\/strong><\/p>\n
In this tutorial, SuiteCRM will use HTTPS for more secure connection between client and server. For this purpose, we will be using free SSL certificate from Letsencrypt.<\/p>\n
Before generating certificate files, we need to install letsencrypt client agent on the system. It’s available in the Ubuntu repository, so install it with the apt command below.<\/p>\n
apt install -y letsencrypt<\/p>\n
After installing letsencrypt, we need to stop nginx service before generating certificate files.<\/p>\n
systemctl stop nginx<\/p>\n
Now generate SSL Certificate files using the letsencrypt command below.<\/p>\n
letsencrypt certonly –standalone -d suitecrm.hakase-labs.co<\/p>\n
Note: <\/strong>The –standalone<\/em> option will create a temporary web server on the system, so we need to stop the Nginx web server before generating certificate files.<\/p>\n
You will be asked about your email address for renewing notification. Type your email address and click ‘OK’.<\/p>\n
![\"Create](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/02\/how-to-install-suitecrm-with-nginx-on-ubuntu-16-04-6.png\" "\\"\\"")
<\/a><\/p>\nFor the Letsencrypt Agreement, choose ‘Agree’ and press Enter.<\/p>\n
![\"Accept](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/02\/how-to-install-suitecrm-with-nginx-on-ubuntu-16-04-7.png\" "\\"\\"")
<\/a><\/p>\nNew Letsencrypt SSL has been generated in the ‘\/etc\/letsencrypt\/live\/domain.com’ directory.<\/p>\n
![\"SSL](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/02\/how-to-install-suitecrm-with-nginx-on-ubuntu-16-04-8.png\" "\\"\\"")
<\/a><\/p>\n– Configure Nginx Virtual host for SuiteCRM<\/strong><\/p>\n
Go to the Nginx configuration directory and create a new virtual host file ‘suitecrm’ in the ‘sites-available’ directory.<\/p>\n
cd \/etc\/nginx
vim sites-available\/suitecrm<\/p>\nPaste the following Nginx configuration there.<\/p>\n
# Server Config - hakase-labs
\u00a0\u00a0\u00a0 # Automatically redirect to HTTPS
# Nginx SSL for SuiteCRM
\u00a0\u00a0\u00a0 server_name suitecrm.hakase-labs.co;<\/p>
\u00a0\u00a0\u00a0 # Enable http2
\u00a0\u00a0\u00a0 # SSL Config
\u00a0\u00a0\u00a0 client_max_body_size 50M;<\/p>
\u00a0\u00a0\u00a0 index index.php index.html index.htm;
\u00a0\u00a0\u00a0 location \/ {
\u00a0\u00a0\u00a0 location = \/50x.html {
\u00a0\u00a0\u00a0 ## Images and static content is treated different
\u00a0\u00a0\u00a0 location ~ \\.php$ {
\u00a0\u00a0\u00a0 location ~ \/\\.ht {
}<\/p><\/pre>\n
Save and exit.<\/p>\n
Now activate the virtual host, test the configuration, and make sure there is no error. Then restart the web server.<\/p>\n
ln -s \/etc\/nginx\/sites-available\/suitecrm \/etc\/nginx\/sites-enabled\/<\/p>\n
nginx -t
systemctl restart nginx<\/p>\n![\"Configure](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/02\/how-to-install-suitecrm-with-nginx-on-ubuntu-16-04-9.png\" "\\"\\"")
<\/a><\/p>\nSystem configuration for SuiteCRM installation has been completed.<\/p>\n
Step 5 – SuiteCRM Web Installer<\/h2>\n
Open your web browser and type the SuiteCRM URL in the address bar, mine is\u00a0suitecrm.hakase-labs.co<\/em><\/p>\n
You will be redirected to the HTTPS connection and the install.php page.<\/p>\n
On the page that appears, you will see the GNU AFFERO License – check on the ‘I Accept’ and click ‘Next’.<\/p>\n
![\"SuiteCRM](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/02\/how-to-install-suitecrm-with-nginx-on-ubuntu-16-04-10.png\" "\\"\\"")
<\/a><\/p>\nNow you will get the page about system environment for SuiteCRM installation.<\/p>\n
Make sure all results are ‘OK’ as shown in the picture below.<\/p>\n
![\"System](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/02\/how-to-install-suitecrm-with-nginx-on-ubuntu-16-04-11.png\" "\\"\\"")
<\/a><\/p>\nClick ‘Next’ to continue.<\/p>\n
Next comes database and admin user configuration. Type your database info, dbname ‘suitecrm_db’, dbuser ‘crmadmin’ with password ‘hakase-labs123’. And type your admin user, password, and email as shown below.<\/p>\n
![\"Database](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/02\/how-to-install-suitecrm-with-nginx-on-ubuntu-16-04-12.png\" "\\"\\"")
<\/a><\/p>\nScroll to the bottom and click ‘Next’ to continue installing SuiteCRM.<\/p>\n
Wait for a moment for the installation, and when it’s complete, you will be redirected to the login page as below.<\/p>\n
![\"SuiteCRM](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/02\/how-to-install-suitecrm-with-nginx-on-ubuntu-16-04-13.png\" "\\"\\"")
<\/a><\/p>\n![\"SuiteCRM](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/02\/how-to-install-suitecrm-with-nginx-on-ubuntu-16-04-14.png\" "\\"\\"")
<\/a><\/p>\n