Instalación Matomo · 7 min read · Dec 17, 2025

Cómo instalar Matomo Web Analytics en Debian 9

Matomo (anteriormente Piwik) es una aplicación de análisis web gratuita y de código abierto desarrollada por un equipo de desarrolladores internacionales, que se ejecuta en un servidor web PHP / MySQL. Realiza un seguimiento de las visitas en línea a uno o más sitios web y muestra informes sobre estas visitas para su análisis. Puedes pensar en ello como una alternativa a Google Analytics. Matomo es de código abierto y su código está disponible públicamente en Github. Algunas de las características que tiene son: Pruebas A/B, Mapas de Calor, Embudos, API de Seguimiento e Informes, Google AdWords, Facebook Ads, Bing Ads, Costo Por Clic (CPC), etc. Este tutorial te mostrará cómo instalar Matomo en un sistema Debian 9 (stretch) utilizando Nginx como servidor web y aseguraremos el sitio web con un certificado SSL de Let’s Encrypt.

Requisitos

Para ejecutar Matomo (Piwik) en tu sistema Debian necesitarás un par de cosas:

  • Servidor web como Apache o Nginx.
  • Versión de PHP 5.5.9 o superior con extensiones pdo y pdo_mysql o mysqli, gd, xml, curl y mbstring. Se recomienda PHP 7+.
  • Versión de MySQL 5.5 o superior, o la versión equivalente de MariaDB. Se recomienda MySQL 5.7+.

Prerrequisitos

  • Un sistema operativo que ejecute Debian 9 (stretch).
  • Un usuario no root con privilegios sudo.

Pasos iniciales

Verifica tu versión de Debian:

lsb_release -ds  
# Debian GNU/Linux 9.6 (stretch)

Configura la zona horaria:

dpkg-reconfigure tzdata

Actualiza los paquetes de tu sistema operativo (software). Este es un primer paso importante porque asegura que tengas las últimas actualizaciones y correcciones de seguridad para los paquetes de software predeterminados de tu sistema operativo:

apt update && apt upgrade -y

Instala algunos paquetes esenciales que son necesarios para la administración básica del sistema operativo Debian:

apt install -y curl wget vim git unzip socat sudo

Paso 1 - Instalar MySQL y crear una base de datos para Matomo

Matomo soporta bases de datos MySQL y MariaDB. El equipo de Debian reemplazó MySQL con MariaDB como la base de datos predeterminada desde Debian 9 (stretch), así que en este tutorial, utilizaremos MariaDB como el servidor de base de datos. Si deseas instalar el MySQL original, puedes agregar y usar el repositorio oficial de MySQL mantenido por Oracle.

Instala el servidor de base de datos MariaDB:

sudo apt install -y mariadb-server

Verifica la versión de MariaDB:

mysql --version  
# mysql  Ver 14.14 Distrib 5.7.24, for Linux (x86_64) using  EditLine wrapper

Ejecuta el script mysql_secure_installation para mejorar la seguridad de MariaDB y establecer la contraseña para el usuario root de MariaDB:

sudo mysql_secure_installation

Responde a cada una de las preguntas:

Introduce la contraseña actual para root (presiona Enter si no hay):  Presiona Enter  
¿Establecer contraseña para root? [Y/n] y  
Nueva contraseña: tu_contraseña_segura  
Reingresa la nueva contraseña: tu_contraseña_segura  
¿Eliminar usuarios anónimos? [Y/n] Y  
¿Deshabilitar el acceso remoto para root? [Y/n] Y  
¿Eliminar la base de datos de prueba y el acceso a ella? [Y/n] Y  
¿Recargar las tablas de privilegios ahora? [Y/n] Y**``

Conéctate al shell de MariaDB como el usuario root:

sudo mysql -u root -p  
# Introduce la contraseña

Crea una base de datos vacía de MariaDB y un usuario para Matomo y recuerda las credenciales:

mysql> CREATE DATABASE dbname;  
mysql> GRANT ALL ON dbname.* TO 'username' IDENTIFIED BY 'password';  
mysql> FLUSH PRIVILEGES;

Sal de MariaDB:

mysql> exit

Reemplaza dbname, username y password con tus propios nombres.

Paso 2 - Instalar PHP y las extensiones PHP necesarias

Instala PHP, así como las extensiones PHP necesarias:

sudo apt install -y php7.0 php7.0-cli php7.0-fpm php7.0-common php7.0-curl php7.0-gd php7.0-xml php7.0-mbstring php7.0-mysql

Verifica la versión de PHP:

php --version  
  
# PHP 7.0.33-0+deb9u1 (cli) (built: Dec  7 2018 11:36:49) ( NTS )  
# Copyright (c) 1997-2017 The PHP Group  
# Zend Engine v3.0.0, Copyright (c) 1998-2017 Zend Technologies  
#     with Zend OPcache v7.0.33-0+deb9u1, Copyright (c) 1999-2017, by Zend Technologies

El servicio PHP-FPM se inicia automáticamente y se habilita en el arranque en el sistema Debian 9, por lo que no es necesario iniciarlo y habilitarlo manualmente. Podemos pasar al siguiente paso, que es obtener certificados SSL gratuitos de Let’s Encrypt CA.

Paso 3 - Instalar el cliente acme.sh y obtener el certificado de Let’s Encrypt (opcional)

Asegurar tu sitio web con HTTPS no es necesario, pero es una buena práctica asegurar el tráfico de tu sitio. Para obtener un certificado TLS de Let’s Encrypt utilizaremos el cliente acme.sh. Acme.sh es un software de shell Unix puro para obtener certificados TLS de Let’s Encrypt sin dependencias.

Descarga e instala acme.sh:

sudo mkdir /etc/letsencrypt  
git clone https://github.com/Neilpang/acme.sh.git  
cd acme.sh  
sudo ./acme.sh --install --home /etc/letsencrypt --accountemail [email protected]  
cd ~

Verifica la versión de acme.sh:

/etc/letsencrypt/acme.sh --version  
# v2.8.0

Obtén certificados RSA y ECC/ECDSA para tu dominio/nombre de host:

# RSA 2048  
sudo /etc/letsencrypt/acme.sh --issue --standalone --home /etc/letsencrypt -d example.com --keylength 2048  
# ECDSA  
sudo /etc/letsencrypt/acme.sh --issue --standalone --home /etc/letsencrypt -d example.com --keylength ec-256

Después de ejecutar los comandos anteriores, tus certificados y claves estarán en:

  • Para RSA: directorio /etc/letsencrypt/example.com.
  • Para ECC/ECDSA: directorio /etc/letsencrypt/example.com_ecc.

Paso 3 - Instalar NGINX y configurar NGINX para Matomo

Matomo puede funcionar bien con muchos software de servidor web populares. En este tutorial, seleccionamos Nginx.

Descarga e instala Nginx desde el repositorio de Debian:

sudo apt install -y nginx

Verifica la versión de Nginx:

sudo nginx -v  
# nginx version: nginx/1.10.3

Configura Nginx para Matomo ejecutando:

sudo vim /etc/nginx/sites-available/matomo.conf

Y llena el archivo con la siguiente configuración:

server {  
  
  listen [::]:443 ssl http2;  
  listen 443 ssl http2;  
  listen [::]:80;  
  listen 80;  
  
  server_name example.com;  
  root /var/www/matomo/;  
  index index.php;  
  
  ssl_certificate /etc/letsencrypt/example.com/fullchain.cer;   
  ssl_certificate_key /etc/letsencrypt/example.com/example.com.key;   
  ssl_certificate /etc/letsencrypt/example.com_ecc/fullchain.cer;  
  ssl_certificate_key /etc/letsencrypt/example.com_ecc/example.com.key;  
  
  location ~ ^/(index|matomo|piwik|js/index).php {  
    include snippets/fastcgi-php.conf;  
    fastcgi_param HTTP_PROXY "";   
    fastcgi_pass unix:/var/run/php/php7.0-fpm.sock;   
  }    
  
  location = /plugins/HeatmapSessionRecording/configs.php {  
    include snippets/fastcgi-php.conf;  
    fastcgi_param HTTP_PROXY "";  
    fastcgi_pass unix:/var/run/php/php7.0-fpm.sock;  
  }  
  
  location ~* ^.+\.php$ {  
    deny all;  
    return 403;  
  }  
  
  location / {  
    try_files $uri $uri/ =404;  
  }    
  
  location ~ /(config|tmp|core|lang) {  
    deny all;  
    return 403;  
  }  
  
  location ~ \.(gif|ico|jpg|png|svg|js|css|htm|html|mp3|mp4|wav|ogg|avi|ttf|eot|woff|woff2|json)$ {  
    allow all;  
  }  
  
  location ~ /(libs|vendor|plugins|misc/user) {  
    deny all;  
    return 403;  
  }  
  
}

NOTA: Para una configuración completa y lista para producción de Nginx para Matomo visita https://github.com/matomo-org/matomo-nginx.

Activa la nueva configuración matomo.conf vinculando el archivo al directorio sites-enabled.

sudo ln -s /etc/nginx/sites-available/matomo.conf /etc/nginx/sites-enabled

Verifica la configuración de Nginx en busca de errores de sintaxis:

sudo nginx -t

Recarga el servicio de Nginx:

sudo systemctl reload nginx.service

Paso 4 - Instalar Matomo Analytics

Crea el directorio /var/www:

sudo mkdir -p /var/www

Navega al directorio /var/www:

cd /var/www/

Descarga la última versión de Matomo a través de wget y descomprímelo:

sudo wget https://builds.matomo.org/matomo.zip && sudo unzip matomo.zip

Elimina el archivo matomo.zip descargado:

sudo rm matomo.zip

Cambia la propiedad del directorio /var/www/matomo al usuario www-data:

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

Paso 5 - Completa la configuración de Matomo Analytics

Abre tu sitio en un navegador web y sigue el asistente de instalación web de Matomo.

Primero, debería aparecer el mensaje de bienvenida de Matomo. Haz clic en el botón “Siguiente”:

Asistente de instalación de Matomo

Después, verás una página de “Verificación del sistema”. Si falta algo, verás una advertencia. Si todo está marcado con una marca de verificación verde, haz clic en el botón “Siguiente” para continuar al siguiente paso:

Verificación del sistema

A continuación, completa los detalles de la base de datos y haz clic en el botón “Siguiente”:

Configuración de la base de datos

Si todo salió bien con la configuración de la base de datos, deberías ver el mensaje “¡Tablas creadas con éxito!”:

Creando tablas de base de datos

Crea una cuenta de superusuario de Matomo y haz clic en el botón “Siguiente”:

Crear cuenta de superusuario

A continuación, configura el primer sitio web que te gustaría rastrear y analizar con Matomo. Más adelante, puedes agregar más sitios para rastrear con Matomo:

Agregar sitio web a Matomo

A continuación, se te proporcionará el código de seguimiento de JavaScript para tu sitio que necesitas agregar para comenzar a rastrear.

Código de seguimiento de Javascript

A continuación, deberías ver que la instalación de Matomo se ha completado.

Instalación de Matomo completada

¡Felicidades! Tu instalación de Matomo está completa.

Enlaces

Share: X/Twitter LinkedIn
#Instalación Matomo

Recibe nuevas publicaciones en tu bandeja de entrada.

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