Web Analytics · 11 min read · Dec 21, 2025

Come installare Matomo Web Analytics su Ubuntu 22.04

Matomo, precedentemente Piwik, è un software di analisi web gratuito e open-source che può tracciare 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ò essere eseguito con il server di database MySQL o MariaDB.

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

In questo tutorial, configurerai e proteggerai la tua analisi web con Matomo su un server Ubuntu 22.04. Installerai Matomo web analytics con PHP 8.1, server web Apache2 e database MariaDB e proteggerai il deployment con certificati SSL/TLS tramite Certbot e Letsencrypt. Una volta terminato questo tutorial, sarai in grado di tracciare e monitorare il traffico sui tuoi siti web e otterrai risultati di tracciamento dettagliati sulla tua installazione Matomo self-hosted.

Prerequisiti

Di seguito sono riportati i requisiti che devi avere per completare questo tutorial:

  • Un server Ubuntu 22.04 - Questo esempio utilizza un server Ubuntu con il nome host ‘ matomo-server ‘.
  • Un utente non root con privilegi di amministratore sudo/root.
  • Un nome di dominio puntato all’indirizzo IP del server - Questo esempio utilizzerà il sottodominio ‘ analytics.howtoforge.local ‘.

Una volta che tutti i requisiti sono a posto, puoi iniziare.

Installazione e configurazione del server MariaDB

Matomo è un’analisi web open-source che utilizza MySQL o MariaDB come backend del database. Al momento della scrittura, Matomo richiedeva almeno MySQL Server v8 o MariaDB v10.x. In questa guida, installerai e utilizzerai MariaDB come database per Matomo web analytics.

Nel primo passaggio, installerai il server MariaDB, configurerai il deployment di MariaDB e creerai un nuovo database e utente MariaDB.

Prima di iniziare, esegui il comando apt qui sotto per aggiornare e rinfrescare l’indice dei pacchetti.

sudo apt update

Ora installa il server MariaDB tramite il comando apt qui sotto. Quando richiesto, inserisci y e premi INVIO per procedere.

sudo apt install mariadb-server

install mariadb

Dopo che il server MariaDB è stato installato, esegui il comando systemctl qui sotto per verificare e assicurarti che il server MariaDB sia in esecuzione.

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

Dovresti ricevere un output simile a questo - Il server MariaDB è abilitato e in esecuzione per impostazione predefinita. Inoltre, il server MariaDB si avvierà automaticamente all’avvio.

verify mariadb

Successivamente, proteggerai il deployment del server MariaDB tramite il comando ‘ mariadb-secure-installation ‘, fornito dal pacchetto del server MariaDB.

Esegui il comando qui sotto per proteggere il deployment del server MariaDB.

sudo mariadb-secure-installation

Ti verrà ora chiesto riguardo le seguenti configurazioni di MariaDB:

  • Passare l’autenticazione locale a unix_socket? Inserisci n.
  • Configurare la nuova password di root di MariaDB? Inserisci y per confermare, quindi digita la nuova password per il tuo deployment del 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.

Ora il deployment del server MariaDB dovrebbe essere protetto e hai aggiunto la password per l’utente root di MariaDB.

Successivamente, creerai un nuovo database e utente MariaDB per l’installazione di Matomo tramite la shell di MariaDB.

Esegui il comando ‘mariadb’ qui sotto per accedere alla shell di MariaDB tramite l’utente root di MariaDB. Quando ti viene chiesta la password, inserisci la tua password di root di MariaDB.

sudo mariadb -u root -p

Ora esegui le seguenti query per creare un nuovo database e utente MariaDB. In questo esempio, creerai il database e l’utente ‘ matomo ‘ per l’installazione di Matomo. Inoltre, assicurati di sostituire la password predefinita nella seguente query.

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

create datbase and user

Successivamente, esegui la query qui sotto per verificare l’elenco dei privilegi dell’utente ‘ matomo@localhost ‘.

SHOW GRANTS FOR 'matomo'@'localhost';  
quit

Dovresti ricevere un output simile a questo - L’utente MariaDB ‘matomo@localhost’ ha tutti i privilegi per accedere al database ‘matomo’.

show privileges

In questa sezione, hai installato il server MariaDB, protetto il deployment di MariaDB tramite il comando ‘ mariadb-secure-installation ‘ e creato un nuovo database e utente per Matomo. Successivamente, installerai il server web Apache2 e PHP 8.x.

Installazione del server web Apache2 e PHP 8

Matomo è un’analisi web open-source scritta in PHP. Per l’installazione, l’ultima versione di Matomo è completamente supportata con PHP 8.x. Inoltre, Matomo può essere eseguito con i server web Apache2 e Nginx.

In questo passaggio, installerai ora il server web Apache2 e PHP 8.1, configurerai l’installazione di PHP, quindi verificherai il servizio Apache2 e la versione di PHP.

Il repository predefinito di Ubuntu fornisce sia i pacchetti Apache2 che PHP. Il repository di Ubuntu 22.04 fornisce l’ultima versione di PHP PHP8.1, che è completamente supportata per l’installazione di Matomo.

Esegui il comando apt qui sotto per installare i pacchetti Apache2 e PHP 8.1.

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

Quando richiesto, inserisci y per confermare e premi INVIO per procedere.

install apache2 php 8

Dopo che Apache2 e PHP sono stati installati, esegui il comando systemctl qui sotto per verificare il servizio Apache2 e assicurarti che il servizio sia in esecuzione.

sudo systemctl is-enabled apache2  
sudo systemctl status apache2

Riceverai un output simile a questo - Il servizio Apache2 è abilitato e verrà eseguito automaticamente all’avvio. E lo stato del servizio Apache2 è in esecuzione.

verify apache2 service

Successivamente, apri il file ‘ php.ini ‘ per Apache2 tramite il comando dell’editor nano qui sotto.

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

Cambia la configurazione predefinita di php.ini con le seguenti righe. Regola il valore di date.timezone e memory_limit con il tuo ambiente attuale.

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

Salva ed esci dal file quando hai finito.

Ora esegui il comando systemctl qui sotto per riavviare il servizio Apache2 e applicare le modifiche.

sudo systemctl restart apache2

Il server web Apache2 dovrebbe ora essere in esecuzione con il nuovo file di configurazione php.ini.

Infine, esegui il comando php qui sotto per verificare la versione di PHP installata sul tuo sistema. Quindi verifica l’elenco delle estensioni PHP che sono abilitate.

sudo php --version  
sudo php -m

Dovresti ricevere un output simile a questo - PHP 8.1 è installato sul tuo sistema Ubuntu. Inoltre, assicurati che le estensioni PHP richieste per Matomo siano abilitate.

verify php version

Ora hai finito di installare le dipendenze per Matomo web analytics, incluso il server MariaDB, il server web Apache2 e PHP 8.1.

Nel passaggio successivo, scaricherai il codice sorgente di Matomo e imposterai i permessi appropriati per la directory di installazione di Matomo in modo che PHP e Apache2 possano leggere ed eseguire l’applicazione Matomo.

Download del codice sorgente di Matomo

In questo passaggio, scaricherai il codice sorgente di Matomo e imposterai i permessi appropriati per la directory di installazione di Matomo.

Cambia la tua directory di lavoro corrente in ‘/var/www/ ‘ e scarica il codice sorgente di Matomo tramite il comando wget.

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

Dopo che il codice sorgente di Matomo è stato scaricato, estrai il codice sorgente di Matomo tramite il comando unzip qui sotto. E dovresti ottenere la nuova directory ‘ matomo ‘ nella tua directory di lavoro corrente.

unzip matomo.zip

Con questo, la tua directory di installazione di Matomo dovrebbe essere ‘/var/www/matomo ‘.

Esegui il comando qui sotto per cambiare la proprietà della directory di installazione di Matomo ‘ /var/www/matomo ‘ all’utente e gruppo ‘ www-data ‘.

sudo chown -R www-data:www-data /var/www/matomo

Dopo aver configurato la directory di installazione di Matomo e scaricato il codice sorgente di Matomo. Successivamente, creerai una nuova configurazione di host virtuale che verrà utilizzata per eseguire Matomo web analytics.

Configurazione dell’host virtuale Matomo

Prima di iniziare, assicurati di avere il nome di dominio puntato all’indirizzo IP del tuo server. Questo esempio utilizza il sottodominio ‘ analytics.howtoforge.local ‘ per l’installazione di Matomo.

Crea un nuovo file di host virtuale Apache2 ‘/etc/apache2/sites-available/matomo.conf ‘ utilizzando il comando dell’editor nano qui sotto.

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

Aggiungi le seguenti righe al file e assicurati di cambiare il nome di dominio con il tuo dominio.

  
    ServerAdmin webmaster@localhost  
    ServerName analytics.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 dall’editor quando hai finito.

Successivamente, esegui il comando qui sotto per attivare la nuova configurazione dell’host virtuale ‘ matomo.conf ‘. Quindi verifica le configurazioni di Apache2 per assicurarti che la tua configurazione corretta non abbia errori.

sudo a2ensite matomo.conf  
sudo apachectl configtest

Dovresti ricevere un output come ‘ Syntax OK ‘ quando hai configurazioni Apache2 corrette.

setup virtual host matomo

Infine, esegui il comando systemctl qui sotto per riavviare il servizio Apache2 e applicare le modifiche.

sudo systemctl restart apache2

Con questo, hai ora finito la configurazione dell’host virtuale Apache2 per Matomo web analytics. Questo significa che il tuo Matomo è ora accessibile dall’esterno della rete e puoi accedervi tramite il browser web. Ma, questo utilizza ancora connessioni HTTP non sicure.

Nel passaggio successivo, proteggerai la tua installazione di Matomo web analytics con certificati SSL/TLS tramite Certbot e Letsencrypt.

Proteggere Matomo con SSL/TLS tramite Certbot e Letsencrypt

In questo passaggio, installerai lo strumento Certbot e il plugin per il server web Apache2. Quindi, genererai nuovi certificati SSL/TLS per Matomo web analytics.

Prima di iniziare, assicurati che il tuo nome di dominio sia puntato all’indirizzo IP del tuo server. Inoltre, hai bisogno di un indirizzo email che verrà utilizzato per registrarsi a Letsencrypt.

Ora esegui il comando apt qui sotto per installare lo strumento Certbot e il plugin Certbot per il server web Apache2.

sudo apt install certbot python3-certbot-apache2

Inserisci y quando richiesto e premi INVIO per procedere.

install certbot

Successivamente, esegui il comando certbot qui sotto per generare certificati SSL/TLS per il tuo nome di dominio. Assicurati di cambiare il nome di dominio e l’indirizzo email nel seguente comando.

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

Dopo che il processo è terminato, la tua analisi web Matomo dovrebbe ora essere in esecuzione con HTTPS sicuro abilitato sopra il tuo server web Apache. Inoltre, hai configurato il reindirizzamento automatico da HTTP a HTTPS e abilitato l’OSCP staple.

Installazione di Matomo Web Analytics

Apri il tuo browser web e visita il nome di dominio della tua installazione di Matomo (ad es: https://analytics.howtoforge.local). Dovresti ora ottenere la pagina di benvenuto di Matomo come nello screenshot qui sotto.

Clicca su Avanti per iniziare l’installazione.

welcome to matomo

Ora l’installer di Matomo controllerà gli ambienti del server per l’installazione. Assicurati che tutti i requisiti e le configurazioni siano controllati con il colore verde come qui sotto.

Matomo system checks

Inoltre, devi assicurarti che i requisiti principali siano soddisfatti con i requisiti di sistema di Matomo.

setup database

Clicca su Avanti per continuare.

Ora configurerai i dettagli del database MariaDB per la tua analisi web Matomo. Assicurati di inserire il nome utente e la password del database corretti. Quindi, clicca su Avanti di nuovo.

database setup

L’installer web di Matomo dovrebbe creare automaticamente le tabelle quando i dettagli del tuo database sono corretti.

Clicca su Avanti per continuare.

tables created

Successivamente, dovrai creare un nuovo utente admin per la tua installazione di Matomo web analytics. Assicurati di utilizzare una password forte per il tuo utente admin di Matomo. Quindi clicca su Avanti di nuovo.

create admin

In questo, configurerai il primo tracciamento per il tuo sito web. Nel nome di dominio del tuo sito web che desideri tracciare, seleziona il fuso orario, quindi clicca su Avanti.

setup first tracking

Ora dovresti vedere il codice JavaScript che devi inserire nei tuoi siti web. Clicca su Avanti di nuovo per continuare.

tracking code JavaScript

Dovresti ora ricevere il messaggio di congratulazioni che hai finito l’installazione di Matomo. Clicca sul pulsante CONTINUA A MATOMO in fondo alla pagina.

installation finished

Ora verrai reindirizzato a una connessione HTTPS sicura per la pagina di login dell’amministrazione di Matomo. Inserisci il tuo nome utente e password di Matomo, quindi clicca su ACCEDI.

Matomo login page

Se hai l’utente admin e la password corretti, dovresti ottenere l’amministrazione web di Matomo.

matomo dashboard

Ora clicca sul menu Tutti i siti in alto a destra per ottenere l’elenco dei siti web con tracciamento attivo. Dovresti vedere il primo tracciamento del sito web che hai creato durante l’installazione di Matomo.

Matomo list sites

Hai ora finito l’installazione di Matomo Web Analytics. Puoi aggiungere più siti web e iniziare a tracciare tramite Matomo web analytics self-hosted.

Conclusione

In questo articolo, hai installato l’analisi web open-source Matomo con il server di database MariaDB, il server web Apache2 e PHP 8.1 su un server Ubuntu 22.04. Hai anche protetto Matomo con certificati SSL/TLS generati tramite Certbot e Letsencrypt.

Ora che hai installato le basi di Matomo web analytics, puoi integrare Matomo con CMS (Content Management System) come WordPress, TYPO3, Joomla, Drupal, ecc. Inoltre, puoi integrare con applicazioni di eCommerce come Magento, Prestashop, Woocommerce e OpenCart.

Share: X/Twitter LinkedIn

Ricevi i nuovi post nella tua casella di posta.

Nessuno spam. Disiscriviti in qualsiasi momento.