Come installare Matomo Web Analytics su Debian 12

Matomo, precedentemente Piwik, è un software di analisi web gratuito e open-source che può essere utilizzato per monitorare le visite al sito web e visualizzare report per l’analisi dei dati e del pubblico. Matomo è concesso in licenza sotto la GPL, scritto in PHP e può funzionare con un server di database MySQL o MariaDB.

Matomo fornisce report dettagliati per il monitoraggio degli utenti sui tuoi siti web. Questo include il motore di ricerca di riferimento e le parole chiave, le lingue, le visite alle pagine, i download dei file e altro ancora. Matomo è diventato sempre più popolare come alternativa ai servizi di analisi come Google Analytics.

In questo tutorial, imparerai come installare Matomo web analytics sul server Debian 12. Configurerai Matomo con il LAMP Stack e proteggerai Matomo con HTTPS tramite Certbot e Letsencrypt.

Prerequisiti

Prima di iniziare, assicurati di avere quanto segue:

• 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

Matomo è un’analisi web basata su PHP che utilizza MySQL/MariaDB come database. Per installare Matomo, devi installare il LAMP (Linux, Apache, MySQL/MariaDB e PHP) o il LEMP (Linux, Nginx, MySQL/MariaDB e PHP-FPM) Stack sul tuo sistema. In questo esempio, eseguirai Matomo con il LAMP Stack sul server Debian.

Prima di tutto, esegui il comando apt qui sotto per aggiornare l’indice dei pacchetti Debian.

sudo apt update

Ora installa il LAMP Stack (Linux, Apache, MySQL/MariaDB e PHP) con il seguente comando:

sudo apt install apache2 mariadb-server php php-cli libapache2-mod-php php-common php-curl php-gd php-mbstring php-mysql php-xml php-intl php-zip wget unzip

Inserisci Y per confermare l’installazione.

Dopo che l’installazione è completata, controlla lo stato del server MariaDB con il comando qui sotto. Vedrai il server MariaDB con lo stato attivo (in esecuzione) e abilitato.

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

Ora controlla lo stato del servizio Apache con il seguente comando. Nell’output seguente, puoi vedere che il server web Apache è in esecuzione.

sudo systemctl is-enabled apache2  
sudo systemctl status apache2

Infine, esegui il comando php qui sotto per controllare la versione di PHP. Vedrai che PHP 8.3 è installato.

php -v

Configurazione di PHP

Dopo aver installato il LAMP Stack, configurerai l’installazione di PHP modificando il file php.ini e riavviando il server web Apache.

Apri la configurazione PHP predefinita /etc/php/8.3/apache2/php.ini con il seguente editor nano.

sudo nano /etc/php/8.3/apache2/php.ini

Cambia la configurazione predefinita come segue - Assicurati di modificare sia le opzioni date.timezone che memory_limit in base all’ambiente del tuo server attuale.

date.timezone = Europe/Stockholm  
memory_limit = 256M  
upload_max_filesize = 16M  
max_execution_time = 300

Salva il file ed esci dall’editor.

Ora esegui il comando systemctl qui sotto per riavviare il server web Apache e applicare le modifiche a PHP.

sudo systemctl restart apache2

Configurazione del server MariaDB

In questa sezione, proteggerai il server MariaDB e imposterai la password di root per esso. Poi, creerai un nuovo database e un utente che saranno utilizzati da Matomo.

Esegui il comando mariadb-secure-installation qui sotto per proteggere MariaDB e impostare la password di root.

sudo mariadb-secure-installation

Ora ti verrà chiesto di rispondere alle seguenti configurazioni:

• Passare dall’autenticazione locale a unix_socket? Inserisci n.
• Imposta la nuova password di root di MariaDB. Inserisci y per confermare, quindi digita la nuova password per il tuo server MariaDB.
• Rimuovere l’utente anonimo? Inserisci y per confermare.
• Rimuovere il database di test predefinito dal deployment? Inserisci y per confermare.
• Vietare il login di root di MariaDB da connessioni remote? Inserisci y per confermare.
• Ricaricare i privilegi delle tabelle e applicare le modifiche? Inserisci y e premi INVIO.

Successivamente, esegui il comando mariadb qui sotto per accedere al server MariaDB. Inserisci la tua password di root quando richiesto.

sudo mariadb -u root -p

Ora esegui le seguenti query per creare un nuovo database e un utente matomo con la password p4ssword. Regola i dettagli del database qui sotto.

CREATE DATABASE matomo;  
CREATE USER 'matomo'@'localhost' IDENTIFIED BY 'p4ssword';  
GRANT SELECT, INSERT, UPDATE, DELETE, CREATE, INDEX, DROP, ALTER, CREATE TEMPORARY TABLES, LOCK TABLES ON matomo.* TO 'matomo'@'localhost';  
FLUSH PRIVILEGES;

Infine, esegui la query qui sotto per controllare l’utente matomo@localhost ed esci dal server MariaDB. Questo garantirà che l’utente matomo@localhost possa accedere al database matomo.

SHOW GRANTS FOR matomo@localhost;  
quit

Download del codice sorgente di Matomo

Ora che hai configurato PHP e creato un database e un utente, puoi installare Matomo. Ora scaricherai il codice sorgente di Matomo, imposterai la directory radice del documento e poi cambierai la proprietà con l’utente Apache corretto.

Vai nella directory /var/www e scarica il codice sorgente di Matomo utilizzando il comando wget qui sotto.

cd /var/www/  
wget https://builds.matomo.org/matomo.zip

Una volta scaricato, esegui il comando unzip qui sotto per estrarre il file matomo.zip. E poi cambia la proprietà della directory /var/www/matomo all’utente www-data.

unzip matomo.zip  
sudo chown -R www-data:www-data /var/www/matomo

Impostazione dell’host virtuale Apache

Dopo aver scaricato Matomo, creerai un nuovo file di host virtuale Apache per Matomo. Assicurati che il tuo nome di dominio sia puntato a un indirizzo IP del server.

Crea un nuovo file di host virtuale Apache /etc/apache2/sites-available/matomo.conf con l’editor nano.

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

Inserisci la configurazione qui sotto e assicurati di sostituire l’opzione ServerName con il tuo nome di dominio.

    ServerAdmin webmaster@localhost
    ServerName matomo.howtoforge.local
    DocumentRoot /var/www/matomo/

    
        DirectoryIndex index.php
        Options FollowSymLinks
        AllowOverride All
        Require all granted
    

    
        Options None
        Require all denied
    

    
        Options None
        Require all granted
    

    
        Options None
        Require all denied
    

    
        Options None
        Require all denied
    

    ErrorLog ${APACHE_LOG_DIR}/matomo_error.log
    CustomLog ${APACHE_LOG_DIR}/matomo_access.log combined

Salva il file ed esci quando hai finito.

Ora esegui il comando a2ensite qui sotto per attivare il file matomo.conf. Poi esegui il comando apachectl qui sotto per verificare la tua configurazione Apache. Se hai una sintassi Apache corretta, vedrai un output Syntax is OK.

sudo a2ensite matomo.conf  
sudo apachectl configtest

Infine, esegui il comando systemctl qui sotto per riavviare il server web Apache e applicare le tue modifiche. Una volta riavviato Apache, la tua installazione di Matomo è pronta.

sudo systemctl restart apache2

Proteggere Matomo con HTTPS

In questa sezione, genererai certificati SSL/TLS e proteggerai Matomo con HTTPS tramite Certbot e Letsencrypt.

Installa i pacchetti certbot e python3-certbot-apache con il comando qui sotto.

sudo apt install certbot python3-certbot-apache

Ora esegui il comando certbot qui sotto per generare certificati SSL e proteggere il tuo nome di dominio matomo. Assicurati di cambiare il nome di dominio e l’indirizzo email con le tue informazioni.

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

Dopo che il processo è completato, i tuoi certificati SSL saranno disponibili nella directory /etc/letsencrypt/live/donmain.com. Inoltre, la tua installazione di Matomo è protetta con HTTPS.

Installazione di Matomo web analytics

Apri il tuo browser web e visita il tuo nome di dominio Matomo, come https://matomo.howtoforge.local/. Se l’installazione ha avuto successo, vedrai il messaggio di benvenuto come il seguente:

Clicca su Avanti per confermare l’installazione.

Nella sezione Controllo di sistema, assicurati che il tuo sistema sia pronto e clicca di nuovo su Avanti.

Ora inserisci i dettagli, incluso il nome del database MariaDB, l’utente e la password, quindi clicca su Avanti per migrare il database.

Una volta migrato, clicca di nuovo su Avanti.

Inserisci un nuovo nome utente amministratore, indirizzo email e password per Matomo web analytics.

Ora inserisci le informazioni per creare il primo tracciamento con Matomo e clicca su Avanti.

Copia il codice di tracciamento generato e clicca su Avanti.

Dopo che l’installazione è completata, vedrai i seguenti messaggi:

Se visiti la pagina principale di Matomo, verrai reindirizzato alla pagina di accesso di Matomo. Inserisci il tuo utente admin e la password, quindi clicca su ACCEDI.

Dopo aver effettuato l’accesso, vedrai il seguente cruscotto di amministrazione di Matomo:

Conclusione

Congratulazioni! Hai completato l’installazione di Matomo web analytics sul server Debian 12. Matomo web analytics è attivo e funzionante con il server web Apache, il server di database MariaDB e PHP 8.3. Hai anche protetto Matomo con HTTPS tramite Certbot e Letsencrypt.