Come installare SuiteCRM su Debian 12

SuiteCRM è un software CRM (Customer Relationship Management) gratuito e open-source scritto in PHP. Ti aiuta a organizzare e gestire i dipartimenti di marketing, vendite e assistenza clienti della tua azienda. SuiteCRM è adatto per quasi ogni settore, come manifatturiero, settori pubblici, tecnologia, finanza, istruzione, ecc.

In questa guida, ti guideremo passo dopo passo attraverso l’installazione di SuiteCRM sul server Debian 12. Installerai e eseguirai SuiteCRM con il LAMP Stack (Apache2, MariaDB e PHP) sulla tua macchina Debian. Inoltre, proteggerai SuiteCRM con certificati SSL/TLS di Letsencrypt.

Requisiti

I seguenti requisiti sono necessari per continuare con questa guida:

• Un server Debian 12.
  Un utente non root con privilegi di amministratore.
  Un nome di dominio puntato a un indirizzo IP del server.

Installazione delle dipendenze

SuiteCRM è un software CRM scritto in PHP con MySQL/MariaDB come database. In questa guida, eseguirai SuiteCRM con il LAMP Stack (Apache2, MariaDB e PHP), e ora installerai i pacchetti del LAMP Stack con estensioni PHP aggiuntive.

Prima di tutto, aggiorna l’indice dei pacchetti Debian tramite il comando apt update qui sotto.

sudo apt update

Ora installa i pacchetti del LAMP Stack (Apache2, MariaDB e PHP) con alcune estensioni PHP utilizzando il seguente comando.

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

Digita y per procedere con l’installazione.

Successivamente, esegui il seguente comando systemctl per verificare il servizio apache2. Questo garantirà che il servizio apache2 sia abilitato e in esecuzione.

sudo systemctl is-enabled apache2  
sudo systemctl status apache2

L’output enabled conferma che apache2 è abilitato, e l’output active (running) conferma che apache2 è in esecuzione.

Verifica il servizio mariadb utilizzando il seguente comando.

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

Simile all’output del servizio apache2, dovresti vedere che il servizio mariadb è abilitato e in esecuzione.

Infine, verifica la versione di PHP e alcune estensioni abilitate eseguendo il seguente comando.

php -v  
php -m

Il seguente output ti mostra che PHP 8.2 è installato con alcuni moduli abilitati come curl, exif, fileinfo e gd.

Configurazione del server MariaDB

Dopo aver installato le dipendenze, proteggerai l’installazione del tuo server MariaDB e creerai un nuovo database e un utente che saranno utilizzati per SuiteCRM.

Esegui il comando mariadb-secure-installation qui sotto per proteggere il tuo server MariaDB.

sudo mariadb-secure-installation

Durante il processo, inserisci Y per confermare la configurazione o n per No e negare le modifiche.

• Passare all’autenticazione unix_socket?. Inserisci n e premi INVIO. L’utente root predefinito di MariaDB è già protetto. Facoltativamente, puoi anche abilitarlo digitando y per sì.
• Cambiare la password di root?. Inserisci y per confermare e impostare la tua nuova password di root di MariaDB.
• Rimuovere l’utente anonimo?. Inserisci y per confermare.
• Vietare l’accesso remoto come root? Inserisci y per confermare. Solo le connessioni locali saranno consentite se stai utilizzando l’utente root di MariaDB.
• Rimuovere il database di test e l’accesso ad esso?. Inserisci y per confermare e rimuovere il database predefinito ‘test’.
• Infine, inserisci y di nuovo per ricaricare tutti i privilegi delle tabelle sul tuo server MariaDB e applicare le nuove modifiche.

Ora che MariaDB è protetto, creerai un nuovo database e un utente per SuiteCRM.

Accedi al server MariaDB tramite il comando client mariadb qui sotto. Inserisci la tua password di root di MariaDB quando richiesto.

sudo mariadb -u root -p

Successivamente, esegui le seguenti query per creare un nuovo database suitecrmdb e l’utente suitecrm con password password. Assicurati di cambiare la password con la tua.

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

Ora esegui la seguente query per verificare l’utente suitecrm.

SHOW GRANTS FOR 'suitecrm'@'localhost';

Nell’output seguente, dovresti vedere che l’utente suitecrm ha accesso al database suitecrmdb.

Digita quit per uscire dal server MariaDB.

Configurazione di PHP

Ora che il server MariaDB è configurato, il passo successivo è configurare la tua installazione di PHP. SuiteCRM richiede alcune modifiche alle configurazioni di PHP, come custom error_reporting, abilitazione del modulo OPCache e anche custom upload_max_filesize e post_max_size.

Apri la configurazione predefinita di PHP /etc/php/8.2/apache2/php.ini e /etc/php/8.2/cli/php.ini utilizzando il seguente comando dell’editor nano.

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

Cambia i parametri predefiniti di alcune configurazioni utilizzando le seguenti righe. Assicurati di regolare il date.timezone con il fuso orario del tuo server e il memory_limit con la memoria del server.

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

Cambia il parametro predefinito error_reporting in questo modo:

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

Decommenta il parametro session.save_path per configurare il percorso di sessione predefinito in /var/lib/php/sessions.

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

Ora abilita l’estensione OPCache e regola alcune impostazioni come segue:

opcache.enable=1  
  
; La dimensione della memoria condivisa OPcache.  
opcache.memory_consumption=256  
  
; Il numero massimo di chiavi (script) nella tabella hash OPcache.  
; Solo numeri tra 200 e 100000 sono consentiti.  
opcache.max_accelerated_files=20000  
  
; Quando disabilitato, devi ripristinare manualmente l'OPcache o riavviare il  
; server web affinché le modifiche al filesystem abbiano effetto.  
opcache.validate_timestamps=0

Salva e chiudi il file quando hai finito.

Ora esegui il seguente comando systemctl per riavviare il servizio apache2 e applicare le modifiche che hai effettuato.

sudo systemctl restart apache2

Scaricare e installare SuiteCRM

A questo punto, il LAMP Stack è ora configurato per SuiteCRM. Ora scaricherai il codice sorgente di SuiteCRM e lo installerai tramite la riga di comando.

Crea una nuova directory /var/www/suitecrm che sarà utilizzata come destinazione per l’installazione di SuiteCRM.

mkdir -p /var/www/suitecrm

Spostati nella directory /var/www/suitecrm e scarica il codice sorgente di SuiteCRM utilizzando il comando wget qui sotto. Assicurati di controllare la pagina di download di SuiteCRM per ottenere l’ultima versione del codice sorgente. In questo momento, SuiteCRM 8.4 è l’ultima versione.

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

Una volta scaricato, estrai il file suitecrm-8-4-0.zip utilizzando il comando unzip qui sotto.

unzip suitecrm-8-4-0.zip

Quindi esegui il seguente comando per impostare i permessi e la proprietà corretti del codice sorgente di 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

Infine, esegui il file binario /var/www/suitecrm/bin/console per installare SuiteCRM tramite la riga di comando. Assicurati di cambiare i dettagli del nome del database, utente, host, nome di dominio di destinazione, utente admin e password che saranno utilizzati per la tua installazione di 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/"

Una volta terminata l’installazione, il seguente output verrà mostrato nel tuo terminale:

Configurazione dell’host virtuale Apache2 per Suite

Nel passo successivo, creerai una nuova configurazione dell’host virtuale Apache2 che sarà utilizzata per eseguire SuiteCRM. Prima di procedere, assicurati di avere un nome di dominio puntato al tuo indirizzo IP del server.

Esegui il comando a2enmod qui sotto per abilitare i moduli Apache2 richiesti da SuiteCRM.

sudo a2enmod rewrite ssl header

Quindi, crea una nuova configurazione dell’host virtuale Apache2 /etc/apache2/sites-available/suitecrm.conf utilizzando il seguente comando dell’editor nano.

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

Inserisci la seguente configurazione e assicurati di cambiare l’opzione ServerName con il tuo nome di dominio.

  
  
 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  
  

Salva e chiudi il file quando hai finito.

Ora esegui il seguente comando per attivare il file dell’host virtuale suitecrm.conf e verificare le tue configurazioni Apache2.

sudo a2ensite suitecrm.conf  
sudo apachectl configtest

Se hai una sintassi corretta, dovresti ricevere l’output Syntax OK.

Successivamente, esegui il comando systemctl qui sotto per riavviare il servizio apache2 e applicare le modifiche.

sudo systemctl restart apache2

Infine, apri il tuo browser web e visita il nome di dominio della tua installazione di SuiteCRM, come http://suitecrm.howtoforge.local/. Se tutto va bene, dovresti vedere la pagina di accesso di SuiteCRM.

Proteggere SuiteCRM con SSL/TLS di Letsencrypt

Con tutto configurato, ora proteggerai SuiteCRM con certificati SSL/TLS di Letsencrypt.

Installa Certbot e il plugin Certbot Apache utilizzando il seguente comando apt install. Digita y per procedere con l’installazione.

sudo apt install certbot python3-certbot-apache

Ora esegui il comando certbot qui sotto per generare certificati SSL/TLS. Assicurati di cambiare il nome di dominio e l’indirizzo email all’interno del seguente comando.

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

Una volta terminato il processo, i tuoi certificati SSL saranno generati nella directory /etc/letsencrypt/live/suitecrm.howtoforge.local. Inoltre, il file dell’host virtuale di SuiteCRM suitecrm.conf sarà automaticamente configurato con HTTPS.

Torna al tuo browser web e visita il nome di dominio di SuiteCRM, dovresti essere reindirizzato alla pagina di accesso di SuiteCRM per connessioni HTTPS sicure. Inserisci il tuo utente admin e la password, quindi fai clic su Login.

Se tutto va bene, dovresti vedere il dashboard di amministrazione di SuiteCRM come il seguente:

Conclusione

Per concludere, hai ora installato con successo SuiteCRM sul server Debian 12 con LAMP Stack (Apache2, MariaDB e PHP). Hai anche protetto SuiteCRM con SSL/TLS Letsencrypt, generato tramite Certbot. Ora puoi utilizzare SuiteCRM come principale applicazione CRM (Customer Relationship Management) per la tua azienda e puoi iniziare aggiungendo il server SMTP alla tua installazione di SuiteCRM.