Cómo instalar Matomo Web Analytics en Debian 12

Matomo, anteriormente Piwik, es un software de análisis web gratuito y de código abierto que se puede utilizar para rastrear visitas a sitios web y mostrar informes para el análisis de datos y audiencia. Matomo está licenciado bajo la Licencia GPL, está escrito en PHP y puede ejecutarse con un servidor de base de datos MySQL o MariaDB.

Matomo proporciona informes perspicaces para el seguimiento de usuarios en sus sitios web. Esto incluye el motor de búsqueda de referencia y palabras clave, idiomas, visitas a páginas, descargas de archivos de visitantes y más. Matomo se ha vuelto cada vez más popular como una alternativa a servicios de análisis como Google Analytics.

En este tutorial, aprenderás cómo instalar Matomo web analytics en el servidor Debian 12. Configurarás Matomo con el LAMP Stack y asegurarás Matomo con HTTPS a través de Certbot y Letsencrypt.

Prerrequisitos

Antes de comenzar, asegúrate de tener lo siguiente:

• Un servidor Debian 12.
• Un usuario no root con privilegios de administrador.
• Un nombre de dominio apuntado a una dirección IP del servidor.

Instalando dependencias

Matomo es un análisis web basado en PHP que utiliza MySQL/MariaDB como base de datos. Para instalar Matomo, debes instalar LAMP (Linux, Apache, MySQL/MariaDB y PHP) o LEMP (Linux, Nginx, MySQL/MariaDB y PHP-FPM) Stack en tu sistema. En este ejemplo, ejecutarás Matomo con el LAMP Stack en el servidor Debian.

Primero, ejecuta el comando apt a continuación para actualizar el índice de paquetes de Debian.

sudo apt update

Ahora instala el LAMP Stack (Linux, Apache, MySQL/MariaDB y PHP) paquetes con el siguiente 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

Ingresa Y para confirmar la instalación.

Después de que la instalación esté completa, verifica el estado del servidor MariaDB con el comando a continuación. Verás el servidor MariaDB con el estado activo (en ejecución) y habilitado.

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

Ahora verifica el estado del servicio Apache con el siguiente comando. En la salida siguiente, puedes ver que el servidor web Apache está en funcionamiento.

sudo systemctl is-enabled apache2  
sudo systemctl status apache2

Por último, ejecuta el comando php a continuación para verificar la versión de PHP. Verás que PHP 8.3 está instalado.

php -v

Configurando PHP

Después de instalar el LAMP Stack, configurarás la instalación de PHP editando el archivo php.ini y reiniciando el servidor web Apache.

Abre la configuración predeterminada de PHP /etc/php/8.3/apache2/php.ini con el siguiente editor nano.

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

Cambia la configuración predeterminada como sigue - Asegúrate de cambiar tanto las opciones date.timezone como memory_limit con tu entorno de servidor actual.

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

Guarda el archivo y sal del editor.

Ahora ejecuta el comando systemctl a continuación para reiniciar el servidor web Apache y aplicar tus cambios a PHP.

sudo systemctl restart apache2

Configurando el servidor MariaDB

En esta sección, asegurarás el servidor MariaDB y configurarás la contraseña de root para él. Luego, crearás una nueva base de datos y un usuario que será utilizado por Matomo.

Ejecuta el comando mariadb-secure-installation a continuación para asegurar MariaDB y configurar la contraseña de root.

sudo mariadb-secure-installation

Ahora se te preguntará sobre las siguientes configuraciones:

• ¿Cambiar la autenticación local a unix_socket? Ingresa n.
• Configurar la nueva contraseña de root de MariaDB. Ingresa y para confirmar, luego escribe la nueva contraseña para tu implementación del servidor MariaDB.
• ¿Eliminar usuario anónimo? Ingresa y para confirmar.
• ¿Eliminar la base de datos de prueba predeterminada de la implementación? Ingresa y para confirmar.
• ¿Deshabilitar el inicio de sesión de root de MariaDB desde conexiones remotas? Ingresa y para confirmar.
• ¿Recargar privilegios de tabla y aplicar los cambios? Ingresa y y presiona ENTER.

A continuación, ejecuta el comando mariadb a continuación para iniciar sesión en el servidor MariaDB. Ingresa tu contraseña de root cuando se te pida.

sudo mariadb -u root -p

Ahora ejecuta las siguientes consultas para crear una nueva base de datos y un usuario matomo con la contraseña p4ssword. Ajusta los detalles de la base de datos a continuación.

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;

Por último, ejecuta la consulta a continuación para verificar el usuario matomo@localhost y salir del servidor MariaDB. Esto asegurará que el usuario matomo@localhost pueda acceder a la base de datos matomo.

SHOW GRANTS FOR matomo@localhost;  
quit

Descargando el código fuente de Matomo

Ahora que has configurado PHP y creado una base de datos y un usuario, puedes instalar Matomo. Ahora descargarás el código fuente de Matomo, configurarás el directorio raíz del documento y luego cambiarás la propiedad con el usuario de Apache adecuado.

Ve al directorio /var/www y descarga el código fuente de Matomo usando el comando wget a continuación.

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

Una vez descargado, ejecuta el comando unzip a continuación para extraer el archivo matomo.zip. Y luego cambia la propiedad del directorio /var/www/matomo al usuario www-data.

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

Configurando el host virtual de Apache

Después de haber descargado Matomo, crearás un nuevo archivo de host virtual de Apache para Matomo. Así que asegúrate de que tu nombre de dominio esté apuntado a una dirección IP del servidor.

Crea un nuevo archivo de host virtual de Apache /etc/apache2/sites-available/matomo.conf con el editor nano.

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

Inserta la configuración a continuación y asegúrate de reemplazar la opción ServerName con tu nombre de 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

Guarda el archivo y sal cuando termines.

Ahora ejecuta el comando a2ensite a continuación para activar el archivo matomo.conf. Luego ejecuta el comando apachectl a continuación para verificar tu configuración de Apache. Si tienes una sintaxis de Apache adecuada, verás una salida Syntax is OK.

sudo a2ensite matomo.conf  
sudo apachectl configtest

Por último, ejecuta el comando systemctl a continuación para reiniciar el servidor web Apache y aplicar tus cambios. Una vez que Apache se reinicie, tu instalación de Matomo estará lista.

sudo systemctl restart apache2

Asegurando Matomo con HTTPS

En esta sección, generarás certificados SSL/TLS y asegurarás Matomo con HTTPS a través de Certbot y Letsencrypt.

Instala los paquetes certbot y python3-certbot-apache con el comando a continuación.

sudo apt install certbot python3-certbot-apache

Ahora ejecuta el comando certbot a continuación para generar certificados SSL y asegurar tu nombre de dominio de matomo. Asegúrate de cambiar el nombre de dominio y la dirección de correo electrónico con tu información.

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

Después de que el proceso esté completo, tus certificados SSL estarán disponibles en el directorio /etc/letsencrypt/live/donmain.com. Además, tu instalación de Matomo está asegurada con HTTPS.

Instalando Matomo web analytics

Abre tu navegador web y visita tu nombre de dominio de Matomo como https://matomo.howtoforge.local/. Si la instalación es exitosa, verás el mensaje de bienvenida como el siguiente:

Haz clic en Siguiente para confirmar la instalación.

En la sección Verificación del sistema, asegúrate de que tu sistema esté listo y haz clic en Siguiente nuevamente.

Ahora ingresa los detalles, incluyendo el nombre de la base de datos MariaDB, usuario y contraseña, y luego haz clic en Siguiente para migrar la base de datos.

Una vez migrado, haz clic en Siguiente nuevamente.

Ingresa un nuevo nombre de usuario de administrador, dirección de correo electrónico y contraseña para Matomo web analytics.

Ahora ingresa información para crear el primer seguimiento con Matomo y haz clic en Siguiente.

Copia el código de seguimiento generado y haz clic en Siguiente.

Después de que la instalación esté completa, verás los siguientes mensajes:

Si visitas la página de inicio de Matomo, serás redirigido a la página de inicio de sesión de matomo. Ingresa tu usuario administrador y contraseña, y haz clic en INICIAR SESIÓN.

Después de iniciar sesión, verás el siguiente panel de administración de Matomo:

Conclusión

¡Felicidades! Has completado la instalación de Matomo web analytics en el servidor Debian 12. Matomo web analytics está en funcionamiento con el servidor web Apache, el servidor de base de datos MariaDB y PHP 8.3. También aseguraste Matomo con HTTPS a través de Certbot y Letsencrypt.