Análisis web · 12 min read · Dec 21, 2025

Cómo instalar Matomo Web Analytics en Ubuntu 22.04

Matomo, anteriormente Piwik, es un software de análisis web gratuito y de código abierto que puede 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 las palabras clave, idiomas, visitas a páginas como descargas de archivos, y muchos más. Matomo se está volviendo cada vez más popular como una alternativa a servicios de análisis como Google Analytics.

En este tutorial, configurará y asegurará su análisis web con Matomo en un servidor Ubuntu 22.04. Instalará Matomo web analytics con PHP 8.1, servidor web Apache2 y base de datos MariaDB y asegurará la implementación con certificados SSL/TLS a través de Certbot y Letsencrypt. Una vez que haya terminado este tutorial, podrá rastrear y monitorear el tráfico en sus sitios web, y obtendrá resultados de seguimiento detallados en su instalación de Matomo autoalojada.

Requisitos previos

A continuación se presentan los requisitos que debe tener para completar este tutorial:

  • Un servidor Ubuntu 22.04 - Este ejemplo utiliza un servidor Ubuntu con el nombre de host ‘ matomo-server ‘.
  • Un usuario no root con privilegios de administrador sudo/root.
  • Un nombre de dominio apuntado a la dirección IP del servidor - Este ejemplo utilizará el subdominio ‘ analytics.howtoforge.local ‘.

Una vez que tenga todos los requisitos en su lugar, puede comenzar.

Instalación y configuración del servidor MariaDB

Matomo es un análisis web de código abierto que utiliza MySQL o MariaDB como backend de base de datos. En el momento de escribir esto, Matomo requería al menos MySQL Server v8 o MariaDB v10.x. En esta guía, instalará y usará MariaDB como la base de datos para Matomo web analytics.

En el primer paso, instalará el servidor MariaDB, configurará la implementación de MariaDB y creará una nueva base de datos y usuario de MariaDB.

Antes de comenzar, ejecute el siguiente comando apt para actualizar y refrescar su índice de paquetes.

sudo apt update

Ahora instale el servidor MariaDB a través del siguiente comando apt. Cuando se le solicite, ingrese y presione ENTER para continuar.

sudo apt install mariadb-server

instalar mariadb

Después de que se instale el servidor MariaDB, ejecute el siguiente comando systemctl para verificar y asegurarse de que el servidor MariaDB esté en funcionamiento.

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

Debería recibir una salida similar a esta: El servidor MariaDB está habilitado y en funcionamiento por defecto. Además, el servidor MariaDB se iniciará automáticamente al arrancar.

verificar mariadb

A continuación, asegurará la implementación del servidor MariaDB a través del comando ‘ mariadb-secure-installation ‘, que es proporcionado por el paquete del servidor MariaDB.

Ejecute el siguiente comando para asegurar la implementación del servidor MariaDB.

sudo mariadb-secure-installation

Ahora se le preguntará sobre las siguientes configuraciones de MariaDB:

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

Ahora la implementación del servidor MariaDB debería estar asegurada y ha agregado la contraseña para el usuario root de MariaDB.

A continuación, creará una nueva base de datos y usuario de MariaDB para la instalación de Matomo a través de la shell de MariaDB.

Ejecute el siguiente comando ‘mariadb’ para iniciar sesión en la shell de MariaDB a través del usuario root de MariaDB. Cuando se le pida la contraseña, ingrese su contraseña root de MariaDB.

sudo mariadb -u root -p

Ahora ejecute las siguientes consultas para crear una nueva base de datos y usuario de MariaDB. En este ejemplo, creará la base de datos y el usuario ‘ matomo ‘ para la instalación de Matomo. Además, asegúrese de reemplazar la contraseña predeterminada en la siguiente consulta.

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;

crear base de datos y usuario

A continuación, ejecute la siguiente consulta para verificar la lista de privilegios del usuario ‘ matomo@localhost ‘.

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

Debería obtener una salida similar a esta: El usuario de MariaDB ‘matomo@localhost’ tiene todos los privilegios para acceder a la base de datos ‘matomo’.

mostrar privilegios

En esta sección, ha instalado el servidor MariaDB, asegurado la implementación de MariaDB a través del comando ‘ mariadb-secure-installation ‘, y creado una nueva base de datos y usuario para Matomo. A continuación, instalará el servidor web Apache2 y PHP 8.x.

Instalación del servidor web Apache2 y PHP 8

Matomo es un análisis web de código abierto escrito en PHP. Para la instalación, la última versión de Matomo es totalmente compatible con PHP 8.x. Además, Matomo puede ejecutarse con servidores web Apache2 y Nginx.

En este paso, ahora instalará el servidor web Apache2 y PHP 8.1, configurará la instalación de PHP, luego verificará el servicio Apache2 y la versión de PHP.

El repositorio predeterminado de Ubuntu proporciona tanto paquetes de Apache2 como de PHP. El repositorio de Ubuntu 22.04 proporciona la última versión de PHP 8.1, que es totalmente compatible con la instalación de Matomo.

Ejecute el siguiente comando apt para instalar los paquetes de Apache2 y 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

Cuando se le solicite, ingrese y presione ENTER para continuar.

instalar apache2 php 8

Después de que se instalen Apache2 y PHP, ejecute el siguiente comando systemctl para verificar el servicio Apache2 y asegurarse de que el servicio esté en funcionamiento.

sudo systemctl is-enabled apache2  
sudo systemctl status apache2

Recibirá una salida como esta: El servicio Apache2 está habilitado y se ejecutará automáticamente al arrancar. Y el estado del servicio Apache2 está en funcionamiento.

verificar servicio apache2

A continuación, abra el archivo ‘ php.ini ‘ para Apache2 a través del siguiente comando del editor nano.

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

Cambie la configuración predeterminada de php.ini con las siguientes líneas. Ajuste el valor de date.timezone y memory_limit con su entorno actual.

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

Guarde y salga del archivo cuando haya terminado.

Ahora ejecute el siguiente comando systemctl para reiniciar el servicio Apache2 y aplicar los cambios.

sudo systemctl restart apache2

El servidor web Apache2 ahora debería estar funcionando con el nuevo archivo de configuración php.ini.

Por último, ejecute el siguiente comando php para verificar la versión de PHP que está instalada en su sistema. Luego verifique la lista de extensiones de PHP que están habilitadas.

sudo php --version  
sudo php -m

Debería recibir una salida similar a esta: PHP 8.1 está instalado en su sistema Ubuntu. Además, asegúrese de que las extensiones de PHP que se requieren para Matomo estén habilitadas.

verificar versión php

Ahora ha terminado de instalar las dependencias para Matomo web analytics, incluido el servidor MariaDB, el servidor web Apache2 y PHP 8.1.

En el siguiente paso, descargará el código fuente de Matomo y configurará los permisos adecuados para el directorio de instalación de Matomo para que PHP y Apache2 puedan leer y ejecutar la aplicación Matomo.

Descargando el código fuente de Matomo

En este paso, descargará el código fuente de Matomo y configurará los permisos adecuados para el directorio de instalación de Matomo.

Cambie su directorio de trabajo actual a ‘/var/www/ ‘ y descargue el código fuente de Matomo a través del comando wget.

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

Después de que se descargue el código fuente de Matomo, extraiga el código fuente de Matomo a través del comando unzip a continuación. Y debería obtener el nuevo directorio ‘ matomo ‘ en su directorio de trabajo actual.

unzip matomo.zip

Con esto, su directorio de instalación de Matomo debería ser ‘/var/www/matomo ‘.

Ejecute el siguiente comando para cambiar la propiedad del directorio de instalación de Matomo ‘ /var/www/matomo ‘ al usuario y grupo ‘ www-data ‘.

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

Después de haber configurado el directorio de instalación de Matomo y descargado el código fuente de Matomo. A continuación, creará una nueva configuración de host virtual que se utilizará para ejecutar Matomo web analytics.

Configurando el host virtual Matomo

Antes de comenzar, asegúrese de que su nombre de dominio esté apuntado a la dirección IP de su servidor. Este ejemplo utiliza el subdominio ‘ analytics.howtoforge.local ‘ para la instalación de Matomo.

Cree un nuevo archivo de host virtual de Apache2 ‘/etc/apache2/sites-available/matomo.conf ‘ utilizando el siguiente comando del editor nano.

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

Agregue las siguientes líneas al archivo y asegúrese de cambiar el nombre de dominio por su 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  
  

Guarde el archivo y salga del editor cuando haya terminado.

A continuación, ejecute el siguiente comando para activar la nueva configuración de host virtual ‘ matomo.conf ‘. Luego verifique las configuraciones de Apache2 para asegurarse de que tiene la configuración adecuada sin errores.

sudo a2ensite matomo.conf  
sudo apachectl configtest

Debería recibir una salida como ‘ Syntax OK ‘ cuando tenga configuraciones de Apache2 adecuadas.

configurar host virtual matomo

Por último, ejecute el siguiente comando systemctl para reiniciar el servicio Apache2 y aplicar los cambios.

sudo systemctl restart apache2

Con esto, ha terminado la configuración del host virtual de Apache2 para Matomo web analytics. Esto significa que su Matomo ahora es accesible desde fuera de la red y puede acceder a él a través del navegador web. Pero, esto aún utiliza conexiones HTTP inseguras.

En el siguiente paso, asegurará su instalación de Matomo web analytics con certificados SSL/TLS a través de Certbot y Letsencrypt.

Asegurando Matomo con SSL/TLS a través de Certbot y Letsencrypt

En este paso, instalará la herramienta Certbot y el complemento para el servidor web Apache2. Luego, generará nuevos certificados SSL/TLS para Matomo web analytics.

Antes de comenzar, asegúrese de que su nombre de dominio esté apuntado a la dirección IP de su servidor. Además, necesita una dirección de correo electrónico que se utilizará para registrarse en Letsencrypt.

Ahora ejecute el siguiente comando apt para instalar la herramienta Certbot y el complemento Certbot para el servidor web Apache2.

sudo apt install certbot python3-certbot-apache2

Ingrese y cuando se le solicite y presione ENTER para continuar.

instalar certbot

A continuación, ejecute el siguiente comando certbot para generar certificados SSL/TLS para su nombre de dominio. Asegúrese de cambiar el nombre de dominio y la dirección de correo electrónico en el siguiente comando.

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

Después de que el proceso haya finalizado, su Matomo web analytics ahora debería estar funcionando con HTTPS seguro habilitado sobre su servidor web Apache. Además, tiene la redirección automática configurada de HTTP a HTTPS y el OSCP staple habilitado.

Instalando Matomo Web Analytics

Abra su navegador web y visite el nombre de dominio de su instalación de Matomo (es decir: https://analytics.howtoforge.local). Ahora debería obtener la página de bienvenida a Matomo como la siguiente captura de pantalla.

Haga clic en Siguiente para comenzar la instalación.

bienvenido a matomo

Ahora el instalador de Matomo estará verificando los entornos del servidor para la instalación. Asegúrese de que todos los requisitos y configuraciones estén marcados en verde como a continuación.

verificaciones del sistema de Matomo

Además, debe asegurarse de que se cumplan los requisitos principales del sistema de Matomo.

configurar base de datos

Haga clic en Siguiente para continuar.

Ahora configurará los detalles de la base de datos de MariaDB para su Matomo web analytics. Asegúrese de ingresar el nombre de usuario y la contraseña de la base de datos correctos. Luego, haga clic en Siguiente nuevamente.

configuración de base de datos

El instalador web de Matomo debería crear automáticamente tablas cuando los detalles de su base de datos sean correctos.

Haga clic en Siguiente para continuar.

tablas creadas

A continuación, deberá crear un nuevo usuario administrador para su instalación de Matomo web analytics. Asegúrese de usar una contraseña fuerte para su usuario administrador de Matomo. Luego haga clic en Siguiente nuevamente.

crear administrador

En este paso, configurará el primer seguimiento para su sitio web. En el nombre de dominio de su sitio web que desea rastrear, seleccione la zona horaria, luego haga clic en Siguiente.

configurar primer seguimiento

Ahora debería ver el código JavaScript que debe ingresar en sus sitios web. Haga clic en Siguiente nuevamente para continuar.

código de seguimiento JavaScript

Ahora debería recibir el mensaje de felicitaciones de que ha terminado la instalación de Matomo. Haga clic en el botón CONTINUAR A MATOMO en la parte inferior de la página.

instalación finalizada

Ahora será redirigido a una conexión HTTPS segura para la página de inicio de sesión de administración de Matomo. Ingrese su nombre de usuario y contraseña de Matomo, luego haga clic en INICIAR SESIÓN.

página de inicio de sesión de Matomo

Si tiene el usuario administrador y la contraseña correctos, debería obtener la administración web de Matomo web analytics.

tablero de matomo

Ahora haga clic en el menú Todos los sitios web en la parte superior derecha para obtener la lista de sitios web de seguimiento activo. Debería ver el primer seguimiento del sitio web que creó durante la instalación de Matomo.

lista de sitios de Matomo

Ahora ha terminado la instalación de Matomo Web Analytics. Puede agregar más sitios web y comenzar a rastrear a través de Matomo web analytics autoalojado.

Conclusión

En este artículo, ha instalado el análisis web de código abierto Matomo con el servidor de base de datos MariaDB, el servidor web Apache2 y PHP 8.1 en un servidor Ubuntu 22.04. También ha asegurado Matomo con certificados SSL/TLS generados a través de Certbot y Letsencrypt.

Ahora que ha instalado el análisis web básico de Matomo, puede integrar Matomo con CMS (Sistema de Gestión de Contenidos) como WordPress, TYPO3, Joomla, Drupal, etc. Además, puede integrarse con aplicaciones de comercio electrónico como Magento, Prestashop, Woocommerce y OpenCart.

Share: X/Twitter LinkedIn

Recibe nuevas publicaciones en tu bandeja de entrada.

No spam. Cancela la suscripción en cualquier momento.