Comment installer SuiteCRM sur Debian 12

SuiteCRM est un logiciel CRM (Gestion de la Relation Client) gratuit et open-source écrit en PHP. Il vous aide à organiser et gérer les départements marketing, ventes et service client de votre entreprise. SuiteCRM est adapté à presque tous les secteurs, tels que la fabrication, les secteurs publics, la technologie, la finance, l’éducation, etc.

Dans ce guide, nous vous guiderons étape par étape à travers l’installation de SuiteCRM sur le serveur Debian 12. Vous installerez et exécuterez SuiteCRM avec la pile LAMP (Apache2, MariaDB et PHP) sur votre machine Debian. Vous sécuriserez également SuiteCRM avec des certificats SSL/TLS de Letsencrypt.

Prérequis

Les exigences suivantes sont nécessaires pour continuer avec ce guide :

• Un serveur Debian 12.
  Un utilisateur non-root avec des privilèges d’administrateur.
  Un nom de domaine pointé vers une adresse IP de serveur.

Installation des dépendances

SuiteCRM est un logiciel CRM écrit en PHP avec MySQL/MariaDB comme base de données. Dans ce guide, vous exécuterez SuiteCRM avec la pile LAMP (Apache2, MariaDB et PHP), et maintenant vous installerez les paquets de la pile LAMP avec des extensions PHP supplémentaires.

Tout d’abord, mettez à jour votre index de paquets Debian via la commande apt update ci-dessous.

sudo apt update

Maintenant, installez les paquets de la pile LAMP (Apache2, MariaDB et PHP) avec quelques extensions PHP en utilisant la commande suivante.

sudo apt install apache2 mariadb-server php php-cli php-mysql php-bcmath php-xml php-zip php-curl php-mbstring php-gd php-tidy php-intl php-cli php-opcache php-soap php-imap php-ldap unzip

Tapez y pour continuer avec l’installation.

Ensuite, exécutez la commande systemctl suivante pour vérifier le service apache2. Cela garantira que le service apache2 est activé et en cours d’exécution.

sudo systemctl is-enabled apache2  
sudo systemctl status apache2

La sortie enabled confirme qu’apache2 est activé, et la sortie active (running) confirme qu’apache2 est en cours d’exécution.

Vérifiez le service mariadb en utilisant la commande suivante.

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

Comme pour la sortie du service apache2, vous devriez voir que le service mariadb est activé et en cours d’exécution.

Enfin, vérifiez la version de PHP et certaines extensions activées en exécutant la commande suivante.

php -v  
php -m

La sortie suivante vous montre que PHP 8.2 est installé avec certains modules activés tels que curl, exif, fileinfo, et gd.

Configuration du serveur MariaDB

Après avoir installé les dépendances, vous sécuriserez votre installation de serveur MariaDB et créerez une nouvelle base de données et un utilisateur qui seront utilisés pour SuiteCRM.

Exécutez la commande mariadb-secure-installation ci-dessous pour sécuriser votre serveur MariaDB.

sudo mariadb-secure-installation

Au cours du processus, saisissez Y pour confirmer la configuration ou n pour Non et refuser les modifications.

• Passer à l’authentification unix_socket ?. Saisissez n et appuyez sur ENTRER. L’utilisateur root par défaut de MariaDB est déjà protégé. En option, vous pouvez également l’activer en tapant y pour oui.
• Changer le mot de passe root ?. Saisissez y pour confirmer et définir votre nouveau mot de passe root MariaDB.
• Supprimer l’utilisateur anonyme ?. Saisissez y pour confirmer.
• Interdire la connexion root à distance ? Saisissez y pour confirmer. Seule la connexion locale sera autorisée si vous utilisez l’utilisateur root de MariaDB.
• Supprimer la base de données de test et l’accès à celle-ci ?. Saisissez y pour confirmer et supprimer la base de données par défaut ‘test’.
• Enfin, saisissez y à nouveau pour recharger tous les privilèges des tables sur votre serveur MariaDB et appliquer les nouvelles modifications.

Maintenant que MariaDB est sécurisé, vous allez créer une nouvelle base de données et un utilisateur pour SuiteCRM.

Connectez-vous au serveur MariaDB via la commande cliente mariadb ci-dessous. Saisissez votre mot de passe root MariaDB lorsqu’on vous le demande.

sudo mariadb -u root -p

Ensuite, exécutez les requêtes suivantes pour créer une nouvelle base de données suitecrmdb et l’utilisateur suitecrm avec le mot de passe password. Assurez-vous de changer le mot de passe avec votre propre mot de passe.

CREATE DATABASE suitecrmdb;  
CREATE USER 'suitecrm'@'localhost' IDENTIFIED BY 'password';  
GRANT ALL PRIVILEGES ON suitecrmdb.* TO 'suitecrm'@'localhost';  
FLUSH PRIVILEGES;

Exécutez maintenant la requête suivante pour vérifier l’utilisateur suitecrm.

SHOW GRANTS FOR 'suitecrm'@'localhost';

Dans la sortie suivante, vous devriez voir que l’utilisateur suitecrm a accès à la base de données suitecrmdb.

Tapez quit pour quitter le serveur MariaDB.

Configuration de PHP

Maintenant que le serveur MariaDB est configuré, l’étape suivante consiste à configurer votre installation PHP. SuiteCRM nécessite quelques modifications sur les configurations PHP, telles que le rapport d’erreurs personnalisé, l’activation du module OPCache, ainsi que la personnalisation de upload_max_filesize et post_max_size.

Ouvrez la configuration PHP par défaut /etc/php/8.2/apache2/php.ini et /etc/php/8.2/cli/php.ini en utilisant la commande de l’éditeur nano suivante.

sudo nano /etc/php/8.2/apache2/php.ini  
sudo nano /etc/php/8.2/cli/php.ini

Changez les paramètres par défaut de certaines configurations en utilisant les lignes suivantes. Assurez-vous d’ajuster le date.timezone avec votre fuseau horaire de serveur, et le memory_limit avec la mémoire du serveur.

date.timezone = Europe/Amsterdam  
  
max_execution_time = 60  
memory_limit = 256M  
  
upload_max_filesize = 25M  
post_max_size = 25M

Changez le paramètre par défaut error_reporting comme ceci :

error_reporting = E_ALL & ~E_DEPRECATED & ~E_STRICT & ~E_NOTICE & ~E_WARNING

Décommentez le paramètre session.save_path pour configurer le chemin de session par défaut à /var/lib/php/sessions.

session.save_path = "/var/lib/php/sessions"

Activez maintenant l’extension OPCache et ajustez certains paramètres comme suit :

opcache.enable=1  
  
; La taille de stockage en mémoire partagée OPcache.  
opcache.memory_consumption=256  
  
; Le nombre maximum de clés (scripts) dans la table de hachage OPcache.  
; Seuls les nombres entre 200 et 100000 sont autorisés.  
opcache.max_accelerated_files=20000  
  
; Lorsque désactivé, vous devez réinitialiser manuellement l'OPcache ou redémarrer le  
; serveur web pour que les modifications du système de fichiers prennent effet.  
opcache.validate_timestamps=0

Enregistrez et fermez le fichier lorsque vous avez terminé.

Exécutez maintenant la commande systemctl suivante pour redémarrer le service apache2 et appliquer les modifications que vous avez effectuées.

sudo systemctl restart apache2

Télécharger et installer SuiteCRM

À ce stade, la pile LAMP est maintenant configurée pour SuiteCRM. Vous allez maintenant télécharger le code source de SuiteCRM et l’installer via la ligne de commande.

Créez un nouveau répertoire /var/www/suitecrm qui sera utilisé comme installation cible pour SuiteCRM.

mkdir -p /var/www/suitecrm

Déplacez-vous dans le répertoire /var/www/suitecrm et téléchargez le code source de SuiteCRM en utilisant la commande wget ci-dessous. Assurez-vous de vérifier la page de téléchargement de SuiteCRM pour obtenir la dernière version du code source. À ce moment, SuiteCRM 8.4 est la dernière version.

cd /var/www/suitecrm  
wget https://suitecrm.com/download/142/suite84/562972/suitecrm-8-4-0.zip

Une fois téléchargé, extrayez le fichier suitecrm-8-4-0.zip en utilisant la commande unzip ci-dessous.

unzip suitecrm-8-4-0.zip

Ensuite, exécutez la commande suivante pour définir les permissions et la propriété appropriées du code source de SuiteCRM.

find . -type d -not -perm 2755 -exec chmod 2755 {} \;  
find . -type f -not -perm 0644 -exec chmod 0644 {} \;  
find . ! -user www-data -exec chown www-data:www-data {} \;  
chmod +x bin/console

Enfin, exécutez le fichier binaire /var/www/suitecrm/bin/console pour installer SuiteCRM via la ligne de commande. Assurez-vous de changer les détails du nom de la base de données, de l’utilisateur, de l’hôte, du nom de domaine cible, de l’utilisateur admin et du mot de passe qui seront utilisés pour votre installation de SuiteCRM.

sudo -u www-data ./bin/console suitecrm:app:install -u "alice" -p "password" -U "suitecrm" -P "password" -H "127.0.0.1" -N "suitecrmdb" -S "http://suitecrm.howtoforge.local/"

Une fois l’installation terminée, la sortie suivante sera affichée dans votre terminal :

Configuration de l’hôte virtuel Apache2 pour Suite

Dans l’étape suivante, vous allez créer une nouvelle configuration d’hôte virtuel Apache2 qui sera utilisée pour exécuter SuiteCRM. Avant de continuer, assurez-vous d’avoir un nom de domaine pointé vers l’adresse IP de votre serveur.

Exécutez la commande a2enmod ci-dessous pour activer les modules Apache2 requis par SuiteCRM.

sudo a2enmod rewrite ssl header

Ensuite, créez une nouvelle configuration d’hôte virtuel Apache2 /etc/apache2/sites-available/suitecrm.conf en utilisant la commande de l’éditeur nano suivante.

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

Insérez la configuration suivante et assurez-vous de changer l’option ServerName avec votre nom de domaine.

  
  
 DocumentRoot /var/www/suitecrm/public  
 ServerName suitecrm.howtoforge.local  
  
   
    Options FollowSymLinks  
    AllowOverride All  
   
  
 ErrorLog /var/log/apache2/suitecrm-error.log  
 CustomLog /var/log/apache2/suitecrm-access.log common  
  

Enregistrez et fermez le fichier lorsque vous avez terminé.

Exécutez maintenant la commande suivante pour activer le fichier d’hôte virtuel suitecrm.conf et vérifier vos configurations Apache2.

sudo a2ensite suitecrm.conf  
sudo apachectl configtest

Si vous avez une syntaxe correcte, vous devriez obtenir la sortie Syntax OK.

Ensuite, exécutez la commande systemctl ci-dessous pour redémarrer le service apache2 et appliquer les modifications.

sudo systemctl restart apache2

Enfin, ouvrez votre navigateur web et visitez le nom de domaine de votre installation SuiteCRM, tel que http://suitecrm.howtoforge.local/. Si tout se passe bien, vous devriez voir la page de connexion de SuiteCRM.

Sécuriser SuiteCRM avec SSL/TLS de Letsencrypt

Avec tout configuré, vous allez maintenant sécuriser SuiteCRM avec des certificats SSL/TLS de Letsencrypt.

Installez Certbot et le plugin Certbot Apache en utilisant la commande apt install suivante. Tapez y pour continuer avec l’installation.

sudo apt install certbot python3-certbot-apache

Exécutez maintenant la commande certbot ci-dessous pour générer des certificats SSL/TLS. Assurez-vous de changer le nom de domaine et l’adresse e-mail dans la commande suivante.

sudo certbot --apache --agree-tos --no-eff-email  --redirect --hsts --staple-ocsp --email [email protected] -d suitecrm.howtoforge.local

Une fois le processus terminé, vos certificats SSL seront générés dans le répertoire /etc/letsencrypt/live/suitecrm.howtoforge.local. De plus, le fichier d’hôte virtuel SuiteCRM suitecrm.conf sera automatiquement configuré avec HTTPS.

Retournez dans votre navigateur web et visitez le nom de domaine de votre SuiteCRM, vous devriez être redirigé vers la page de connexion de SuiteCRM pour des connexions HTTPS sécurisées. Saisissez votre utilisateur admin et votre mot de passe, puis cliquez sur Connexion.

Si tout se passe bien, vous devriez voir le tableau de bord d’administration de SuiteCRM comme suit :

Conclusion

Pour conclure, vous avez maintenant installé avec succès SuiteCRM sur le serveur Debian 12 avec la pile LAMP (Apache2, MariaDB et PHP). Vous avez également sécurisé SuiteCRM avec SSL/TLS Letsencrypt, généré via Certbot. Vous pouvez maintenant utiliser SuiteCRM comme l’application principale de CRM (Gestion de la Relation Client) pour votre entreprise, et vous pouvez commencer par ajouter le serveur SMTP à votre installation SuiteCRM.