Cómo instalar Plausible Analytics con un clic (2026)

Plausible Analytics es una alternativa a Google Analytics de código abierto y centrada en la privacidad. No instala cookies, no recopila datos personales y el script de seguimiento pesa menos de 1 KB. Según Plausible, es 54 veces más ligero que Google Analytics y ahorra a cada visitante unos 135 KB de JavaScript.

En esta guía vas a instalar Plausible Analytics en tu propio VPS usando Coolify, un PaaS autoalojado. Una única app predefinida de Docker Compose levanta todo el stack: la aplicación de analítica, PostgreSQL para las cuentas, ClickHouse para los eventos, además de SSL y un proxy inverso.

Plausible CE v3.2.1 (mayo de 2026) es la versión actual. Además es un parche de seguridad que conviene aplicar (detalles en la sección de actualización), así que fija esa etiqueta y no una anterior.

Qué obtienes con Plausible Analytics autoalojado

Lo que v3.x añade respecto a versiones anteriores: equipos y permisos, profundidad de scroll y tiempo de engagement (v3.0.0), el nuevo script de seguimiento configurable (v3.1.0) y «Limit to segment» en los enlaces compartidos (v3.2.0). La segmentación de sitios llegó antes, en la línea v2.1.

Stack de Plausible Analytics autoalojado en Coolify: los visitantes llegan a tu dominio, donde Traefik termina TLS; Plausible CE v3.2.1 guarda las cuentas en PostgreSQL 16 y los eventos en ClickHouse 24.12, ambos en volúmenes persistentes

Requisitos previos

Videotutorial

El vídeo muestra el flujo antiguo del catálogo de servicios de Coolify. Plausible ahora se distribuye como app predefinida de Docker Compose, así que usa los pasos de texto de abajo como la ruta actual (coinciden con las plantillas de Coolify v4.3.x a septiembre de 2026).

Paso 1: Prepara un servidor VPS

Necesitas un VPS para alojar Plausible. Hetzner es mi opción por defecto en relación precio-rendimiento; consulta la review de Hetzner Cloud para más detalles. DigitalOcean, Vultr y Hostinger también funcionan bien. Los números, aquí: comparativa de VPS DigitalOcean vs Vultr vs Hetzner.

Los precios de los VPS subieron en general en 2026. Si estás reconsiderando un servidor alquilado, mira qué cambió y cuándo gana un mini PC.

Para Plausible junto a Coolify y algunos otros servicios, un VPS de 4 GB de RAM y 2 núcleos es el punto de partida adecuado. Esa clase de máquina cuesta unos €5-8/mes en Hetzner.

Paso 2: Instala Coolify

Entra por SSH a tu VPS como root y ejecuta:

curl -fsSL https://cdn.coollabs.io/coolify/install.sh | sudo bash

El script instala Docker Engine, las dependencias y el propio Coolify (actualmente la línea v4.x, v4.3.23 a septiembre de 2026). Abre http://your-server-ip:8000 y crea la cuenta de administrador de inmediato. Es un PaaS autoalojado que controlas por completo; mira nuestra review de Coolify v5 para ver cómo es en el día a día.

Verificación: curl -I http://your-server-ip:8000 devuelve 200 o 302 y el panel carga. Si la página se queda colgada, comprueba ss -tlnp | grep 8000 y docker ps para confirmar que Coolify arrancó.

Para la configuración completa, incluyendo SSL y dominio, consulta la guía de instalación de Coolify.

Paso 3: Apunta un dominio al servidor

Añade un registro A en tu DNS que apunte el hostname de Plausible a la IP del VPS. Por ejemplo, analytics.yourdomain.com → your-server-ip.

Si usas Cloudflare, deja el proxy desactivado (nube gris). El proxy inverso Traefik de Coolify gestiona el SSL mediante Let’s Encrypt automáticamente.

Verificación: dig +short analytics.yourdomain.com devuelve la IP de tu servidor antes de desplegar. Si no es así, espera a que expire el TTL e inténtalo de nuevo. La emisión del certificado falla con un hostname que no resuelve, y Coolify solo te mostrará un destino de proxy roto.

Paso 4: Despliega Plausible Analytics con Coolify

Aquí es donde cambiaron las cosas en 2026. Plausible antes estaba en el catálogo de plantillas de servicios de Coolify. Ahora se distribuye como una app predefinida de Docker Compose (actualizada a v3.2.1 en septiembre de 2026), así que la ruta de clics es distinta a la de tutoriales y vídeos antiguos. La plantilla descarga tres contenedores:

• plausible: ghcr.io/plausible/community-edition:v3.2.1, healthcheck en /api/health
• plausible-db: postgres:16-alpine, healthcheck en pg_isready
• plausible-events-db: clickhouse/clickhouse-server:24.12-alpine, healthcheck en :8123/ping, con una configuración de bajos recursos integrada

4.1 Crea un nuevo recurso Docker Compose

App predefinida (recomendado)

En Coolify, ve a New Resource → Docker Compose → Load from Predefined Apps. Busca “Plausible” (categoría: Analytics) y selecciónalo. Coolify rellena el archivo compose, los healthchecks y los placeholders de entorno que la app necesita.

Las capturas son anteriores al cambio a las apps predefinidas de Docker Compose, así que algunas etiquetas difieren de la UI actual. Sigue los pasos de texto de arriba si hay discrepancias.

Pegar el compose oficial

Esto funciona en cualquier versión de Coolify y te mantiene independiente de su lista de plantillas.

1. New Resource → Docker Compose (vacío).
2. Pega el compose.yml oficial del repositorio community-edition de Plausible.
3. Define al menos BASE_URL y SECRET_KEY_BASE en la configuración de entorno:

BASE_URL=https://analytics.yourdomain.com
SECRET_KEY_BASE=<output of the command below>

openssl rand -base64 48

Si vas por esta ruta, actualiza tú mismo los archivos de community-edition cuando Plausible publique correcciones, no solo la imagen de la app.

No busques Plausible en el antiguo catálogo de servicios. Ya no aparece ahí en las versiones actuales de Coolify.

4.2 Configura el servicio

Define esto en la configuración del servicio:

• Name: cualquier nombre reconocible, como plausible-analytics
• Image tag: v3.2.1 (el valor por defecto de la plantilla a septiembre de 2026)
• URL (FQDN): https://analytics.yourdomain.com. Esto rellena BASE_URL automáticamente a través de SERVICE_URL_PLAUSIBLE.

Coolify también genera los secretos por ti: SECRET_KEY_BASE a partir de SERVICE_BASE64_64_PLAUSIBLE y TOTP_VAULT_KEY a partir de SERVICE_REALBASE64_32_TOTP. No necesitas inventarlos.

Guarda la configuración.

4.3 Variables de entorno

Obligatorias:

• BASE_URL: tu URL de Plausible, p. ej. https://analytics.yourdomain.com. Se define automáticamente si rellenaste el FQDN de arriba.
• SECRET_KEY_BASE: una cadena aleatoria de 64+ caracteres para cifrar sesiones. Coolify la genera; si pegaste el compose tú mismo, usa openssl rand -base64 48. Plausible CE también lee secretos de Docker desde /run/secrets/SECRET_KEY_BASE, que tiene prioridad sobre la variable de entorno; consulta secretos en Docker Compose para ver cómo configurarlos.

Opcionales:

• TOTP_VAULT_KEY: cifra los secretos de autenticación de dos factores. Plausible lo deriva de SECRET_KEY_BASE (PBKDF2) cuando no está definido, así que solo lo configuras si quieres que sea independiente. La plantilla de Coolify lo define de todos modos.

Registro:

• DISABLE_REGISTRATION: por defecto es invite_only, de modo que solo los usuarios que invites pueden crear cuentas. Cuando ya exista tu cuenta de administrador, déjalo así. Pon true para bloquearlo por completo.

SMTP (opcional, para informes por email y restablecer contraseñas):

MAILER_EMAIL=analytics@yourdomain.com
SMTP_HOST_ADDR=smtp.yourdomain.com
SMTP_HOST_PORT=587
SMTP_USER_NAME=analytics@yourdomain.com
SMTP_USER_PWD=your_smtp_password
SMTP_HOST_SSL_ENABLED=true

Sin SMTP, Plausible funciona igual de bien. Simplemente no recibes informes por email ni restablecimientos de contraseña por correo.

Integración con Google Search Console (opcional):

GOOGLE_CLIENT_ID=your_client_id
GOOGLE_CLIENT_SECRET=your_client_secret

Esto permite a Plausible importar datos de consultas de búsqueda desde Google Search Console. Se configura en los ajustes del sitio de Plausible después del despliegue.

Geolocalización a nivel de ciudad (opcional):

IP_GEOLOCATION_DB=MaxMindCity
MAXMIND_LICENSE_KEY=your_maxmind_license
MAXMIND_EDITION=GeoLite2-City

Sin una clave de licencia de MaxMind obtienes ubicación a nivel de país como mucho. La licencia de GeoLite2 es gratuita; regístrate en MaxMind y pega la clave.

Para la lista completa de opciones de configuración, consulta la wiki de configuración de Plausible CE. Si no usas Coolify y quieres que Plausible gestione sus propios certificados, define HTTP_PORT=80 y HTTPS_PORT=443 y emitirá y renovará los certificados de Let’s Encrypt por sí mismo.

Pulsa Deploy. El primer arranque tarda unos minutos mientras se descargan las imágenes y se ejecuta db createdb && db migrate && run al inicio.

4.4 Verifica el despliegue

Ejecuta esto desde el servidor o cualquier máquina que pueda alcanzar el dominio:

# 1. health endpoint should return healthy
curl -fsSL https://analytics.yourdomain.com/api/health

# 2. confirm you are running v3.2.1
docker ps --format '{{.Image}}' | grep plausible
# expect: ghcr.io/plausible/community-edition:v3.2.1

# 3. CVE check: /storybook must NOT return 200 on v3.2.1
curl -sSI https://analytics.yourdomain.com/storybook

Después abre https://analytics.yourdomain.com en un navegador. Debería aparecer la página de registro. Crea tu cuenta de administrador de inmediato: con DISABLE_REGISTRATION=invite_only, cada usuario posterior necesita una invitación tuya.

Paso 5: Añade tu primer sitio

En el panel de Plausible, haz clic en Add a website e introduce el dominio de tu sitio. Abre Site Installation en la configuración del sitio. Plausible genera un snippet único para ese sitio:

<script defer data-domain="yourdomain.com"
  src="https://analytics.yourdomain.com/js/script.js">
</script>

Añádelo al <head> de todas las páginas de tu sitio web. Los eventos personalizados y el seguimiento de ingresos están activados por defecto en el nuevo script. Como el script se carga desde tu propio dominio en lugar de un servidor de terceros, los bloqueadores de anuncios tienen muchas menos probabilidades de bloquearlo que con un servicio de analítica en la nube.

Verificación: carga tu sitio en un navegador y actualiza el panel de Plausible. Una página vista debería aparecer en menos de un minuto. Para pruebas locales antes de que el DNS esté activo, añade captureOnLocalhost: true a las opciones de init de abajo.

Opciones del script de seguimiento

Desde la actualización del script de octubre de 2025 (publicada en Plausible CE v3.1.0), las funciones opcionales son toggles y opciones de plausible.init(), no extensiones de nombre de archivo. El snippet por sitio de Site Installation ya incluye tus elecciones. Si necesitas configurarlas manualmente:

<script defer data-domain="yourdomain.com"
  src="https://analytics.yourdomain.com/js/script.js"></script>
<script>
  plausible.init({
    hashBasedRouting: true,
    fileDownloads: {
      fileExtensions: ["pdf", "xlsx", "docx", "zip"]
    },
    captureOnLocalhost: true,
    autoCapturePageviews: true
  })
</script>

Las opciones que más usarás:

• hashBasedRouting: true: para apps de una sola página con rutas basadas en hash. Sustituye al antiguo script.hash.js.
• fileDownloads: { fileExtensions: [...] }: seguimiento de descargas. De serie vigila los tipos habituales (pdf, xlsx, docx, txt, csv, zip, 7z, rar, mp4, mp3 y similares); pasa tu propia lista para reducirla o ampliarla.
• customProperties: {...}: adjunta propiedades estáticas a cada página vista.
• endpoint: "https://...": envía los eventos a un endpoint personalizado, por ejemplo cuando haces proxy del script. Sustituye al antiguo atributo data-api.
• autoCapturePageviews: false: dispara las páginas vistas manualmente en una SPA.
• captureOnLocalhost: true: necesario para cualquier prueba desde localhost.

El seguimiento de envíos de formularios es un toggle en Site Installation. Dos cosas que el nuevo script eliminó: data-exclude/data-include y el soporte multidominio en un único snippet. Todos los detalles en la guía de actualización del script.

Variantes del script antiguo

Los scripts de extensión antiguos siguen funcionando si ya los usas: script.hash.js, script.outbound-links.js, script.file-downloads.js, script.tagged-events.js y formas combinadas como script.tagged-events.outbound-links.file-downloads.js. Los sitios existentes pueden seguir con ellos. Para sitios nuevos, usa el snippet por sitio de arriba. Es el camino que Plausible desarrolla activamente.

Persistencia de datos y copias de seguridad

Plausible guarda los datos en dos lugares:

• PostgreSQL: cuentas de usuario, configuración de sitios, objetivos. Un conjunto de datos pequeño.
• ClickHouse: los eventos de analítica. Este es el grueso de tus datos.

Ambos se ejecutan en contenedores con volúmenes persistentes gestionados por Coolify. Un redespliegue conserva tus datos.

Una programación sencilla que funciona: copias S3 de Coolify para Postgres más snapshots semanales del VPS para el volumen de eventos. Si alguna vez restauras desde un snapshot, restaura ambos volúmenes desde el mismo punto en el tiempo.

Una nota de actualización: pasar de Plausible v2.x a v3.x requirió una subida de versión de la imagen de ClickHouse (la plantilla ahora usa la 24.12). Si actualizas un despliegue muy antiguo, haz snapshot de los volúmenes primero.

Actualizar Plausible

El flujo de actualización en sí es corto: cambia la etiqueta de imagen en la configuración del servicio de Coolify (por ejemplo de v3.2.0 a v3.2.1) y vuelve a desplegar. Las migraciones se ejecutan al arrancar mediante db createdb && db migrate && run.

Verificación tras actualizar: repite las tres comprobaciones del paso 4.4. Quieres que /api/health devuelva 200, la nueva etiqueta de imagen en docker ps y que /storybook no devuelva 200.

Un detalle de v3.2.0 si pegaste el compose oficial: los ajustes de poca memoria de ClickHouse solo empezaron a aplicarse en v3.2.0 (antes se ignoraban silenciosamente). Actualiza los archivos del repositorio community-edition, no solo la imagen de la app.

Sigue los lanzamientos de Plausible CE para los parches de seguridad. v3.2.1 es una versión solo de seguridad; no hay motivo para quedarse atrás.

Solución de problemas comunes

Más tutoriales de Coolify

• Guía de instalación de Coolify
• Despliega Uptime Kuma con un clic en Coolify
• Coolify vs Dokploy vs Kamal 2

Si Plausible no encaja en tu stack, también puedes instalar Umami Analytics en Docker.

Conclusión

Plausible autoalojado en Coolify te da analítica centrada en la privacidad, sin cookies, sin límites de páginas vistas y sin factura recurrente. La plantilla de Docker Compose de un clic se encarga de las partes difíciles (ClickHouse, PostgreSQL, red, SSL). Tú defines el dominio, despliegas, ejecutas el health check y empiezas a medir.

Un VPS de 4 GB cuesta unos €5-8/mes y aloja Coolify más varios servicios. Plausible Cloud empieza en $9/mes por un sitio con 10k páginas vistas. El script se carga desde tu propio dominio, así que los bloqueadores de anuncios tienen muchas menos probabilidades de bloquearlo que con un servicio en la nube, y los visitantes nunca ven un banner de consentimiento de cookies. Para las listas de filtros más tercas, existe la opción del proxy.

Instala Plausible Analytics una vez, verifícalo y funciona.