Come hang with us on Discord and chat directly with the team!Discordtop-bar-close-icon

2024-10-10

How to Install SuiteCRM on Ubuntu Latest

tutorials
img

Introduction

SuiteCRM is a comprehensive open-source Customer Relationship Management (CRM) solution. It provides a suite of tools to manage all aspects of customer interactions and data. This tutorial will guide you through the installation process of SuiteCRM on the latest version of Ubuntu.

Prerequisites

Before starting, ensure you have the following:

  • A server running the latest version of Ubuntu.
  • A LAMP (Linux, Apache, MySQL, PHP) stack installed on your server.
  • Access to a terminal with root privileges.

Step 1: Update Your System

Begin by updating your package list and upgrading all system packages to their latest versions. Open your terminal and execute these commands:

sudo apt update
sudo apt upgrade -y

Step 2: Install Required PHP Modules

SuiteCRM requires specific PHP modules to function correctly. Install these modules using the following command:

sudo apt install -y php7.4 php7.4-mysql php7.4-xml php7.4-mbstring php7.4-zip php7.4-curl php7.4-gd

Step 3: Download SuiteCRM

Navigate to the SuiteCRM official website to download the latest version. Alternatively, use wget to download directly to your server:

cd /var/www/html
wget https://suitecrm.com/files/162/SuiteCRM-7.11/544/SuiteCRM-7.11.22.zip

Extract the downloaded file:

sudo apt install unzip
unzip SuiteCRM-7.11.22.zip

Rename the extracted directory for convenience:

mv SuiteCRM-7.11.22 suitecrm

Step 4: Set Permissions

Set the correct permissions to ensure SuiteCRM can write to the necessary directories:

sudo chown -R www-data:www-data /var/www/html/suitecrm
sudo chmod -R 755 /var/www/html/suitecrm
sudo chmod -R 775 /var/www/html/suitecrm/cache /var/www/html/suitecrm/custom /var/www/html/suitecrm/modules /var/www/html/suitecrm/upload /var/www/html/suitecrm/data

Step 5: Configure Apache

Create a new Apache configuration file for SuiteCRM:

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

Add the following configuration:

ServerAdmin admin@example.com DocumentRoot /var/www/html/suitecrm ServerName your_domain.com ServerAlias www.your_domain.com Options Indexes FollowSymLinks AllowOverride All Require all granted ErrorLog ${APACHE_LOG_DIR}/error.log CustomLog ${APACHE_LOG_DIR}/access.log combined

Enable the new configuration and rewrite module, then restart Apache:

sudo a2ensite suitecrm.conf
sudo a2enmod rewrite
sudo systemctl restart apache2

Step 6: Set Up the Database

Log in to your MySQL shell and create a database for SuiteCRM:

mysql -u root -p

Enter the following commands in the MySQL shell:

CREATE DATABASE suitecrm;
CREATE USER 'suitecrmuser'@'localhost' IDENTIFIED BY 'yourpassword';
GRANT ALL PRIVILEGES ON suitecrm.* TO 'suitecrmuser'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Step 7: Complete the Installation

Open your web browser and navigate to your server’s domain (e.g., http://your_domain.com). Follow the on-screen instructions to complete the SuiteCRM installation, entering your database details when prompted.

Conclusion

You have successfully installed SuiteCRM on the latest version of Ubuntu. You can now access and start using SuiteCRM to manage your customer relationships effectively.