Instalación Matomo · 6 min read · Dec 23, 2025

Cómo instalar Matomo Web Analytics en Ubuntu 18.04 LTS

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 Ubuntu 18.04 LTS 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 Ubuntu necesitarás un par de cosas:

  • Servidor web como Apache, Nginx, IIS.
  • Versión de PHP 5.5.9 o superior con extensiones pdo y pdo_mysql o mysqli, gd, xml, curl y mbsting. 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 Ubuntu 18.04.
  • Un usuario no root con privilegios sudo.

Pasos iniciales

Verifica tu versión de Ubuntu:

lsb_release -ds  
# Ubuntu 18.04.1 LTS

Configura la zona horaria:

sudo dpkg-reconfigure tzdata

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

sudo apt update && sudo apt upgrade -y

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

sudo apt install -y curl wget vim git unzip socat

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

Matomo soporta bases de datos MySQL y MariaDB. En este tutorial, utilizaremos MySQL como servidor de base de datos.

Instala el servidor de base de datos MySQL:

sudo apt install -y mysql-server

Verifica la versión de MySQL:

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 MySQL y establecer la contraseña para el usuario root de MySQL:

sudo mysql_secure_installation

Responde a cada una de las preguntas:

`¿Te gustaría configurar el plugin VALIDATE PASSWORD? N  
Nueva contraseña: tu_contraseña_segura  
Vuelve a ingresar la nueva contraseña: tu_contraseña_segura  
¿Eliminar usuarios anónimos? [Y/n] Y  
¿Deshabilitar el inicio de sesión remoto del 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 a la consola de MySQL como el usuario root:

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

Crea una base de datos MySQL vacía 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 MySQL:

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.2 php7.2-cli php7.2-fpm php7.2-common php7.2-curl php7.2-gd php7.2-xml php7.2-mbstring php7.2-mysql

Verifica la versión de PHP:

php --version  
  
# PHP 7.2.10-0ubuntu0.18.04.1 (cli) (built: Sep 13 2018 13:45:02) ( NTS )  
# Copyright (c) 1997-2018 The PHP Group  
# Zend Engine v3.2.0, Copyright (c) 1998-2018 Zend Technologies  
#     with Zend OPcache v7.2.10-0ubuntu0.18.04.1, Copyright (c) 1999-2018, by Zend Technologies

El servicio PHP-FPM se inicia automáticamente y se habilita al reiniciar en el sistema Ubuntu 18.04, 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 con cero 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 softwares de servidor web populares. En este tutorial, seleccionamos Nginx.

Descarga e instala la última versión principal de Nginx desde el repositorio de Ubuntu:

sudo apt install -y nginx

Verifica la versión de Nginx:

sudo nginx -v  
# nginx version: nginx/1.14.0

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.2-fpm.sock;   
  }    
  
  location = /plugins/HeatmapSessionRecording/configs.php {  
    include snippets/fastcgi-php.conf;  
    fastcgi_param HTTP_PROXY "";  
    fastcgi_pass unix:/var/run/php/php7.2-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 proceder 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.