Presentación de Uptime Kuma
Uptime Kuma es una herramienta de monitorización autoalojada, desarrollada por Louis Lam y su comunidad bajo licencia MIT. Consulta a intervalos regulares tus sitios web, APIs, puertos TCP, hosts (ping), registros DNS o contenedores Docker, y te avisa por Telegram, Discord, Slack, correo electrónico o webhook cuando algo deja de responder. Su interfaz es clara y se maneja sin necesidad de leer documentación.
Está pensada para desarrolladores, agencias y equipos pequeños que quieren enterarse de que un servicio ha caído antes que sus clientes, sin pagar una suscripción SaaS por monitor. Alojar la herramienta en tu propio VPS te permite, además, conservar el control de los datos de monitorización.
Tras la entrega, el servidor incluye Docker, Uptime Kuma (imagen louislam/uptime-kuma:2) y un proxy inverso Caddy. La aplicación solo escucha en 127.0.0.1:3001, y Caddy la publica en HTTPS por el puerto 443 de la IP pública del servidor, con un certificado autofirmado. Solo queda abrir la URL y crear la cuenta de administrador.
Lo que puede hacer con Uptime Kuma
Muchos tipos de monitores
HTTP(S), palabra clave en una página, TCP, ping, DNS, contenedor Docker y otros. Tú eliges el intervalo de comprobación y el número de fallos antes de avisar.
Alertas en tus canales habituales
Telegram, Discord, Slack, correo SMTP, webhook y muchos otros servicios de notificación están disponibles desde la interfaz, sin plugins que instalar.
Páginas de estado públicas
Publicas una página con el estado de tus servicios para tus clientes o tu equipo, con tu propio dominio si lo deseas.
Seguimiento de certificados TLS
Uptime Kuma lee la fecha de caducidad de los certificados de los sitios HTTPS monitorizados y puede avisarte antes de que expiren.
Docker y Caddy preinstalados
Dos contenedores con reinicio automático (
restart: always), descritos en un archivodocker-compose.ymlque puedes modificar y versionar.Datos en un volumen dedicado
La configuración y el historial de los monitores se almacenan en el volumen Docker
kuma_data, lo que simplifica las copias de seguridad y las actualizaciones.
Empezar con Uptime Kuma
Del pedido a la puesta en producción en pocos minutos.
- 1
Pide el VPS con Uptime Kuma
En el formulario de pedido, elige un VPS Linux (París o Fráncfort) con Debian 12, Debian 13 o Ubuntu 20.04, 22.04, 24.04. En la pestaña «Applications», marca Uptime Kuma.
- 2
Espera la entrega y abre la interfaz
Cuando el servidor esté entregado, la instalación se ejecuta en segundo plano durante unos minutos (descarga de Docker y de las imágenes). Después abre la URL siguiente. El navegador mostrará una advertencia porque el certificado es autofirmado: acepta la excepción para continuar.
Bashhttps://SERVER_IP:443 # Comprobar el estado de los contenedores por SSH: ssh root@SERVER_IP cd /opt/uptime-kuma && docker compose ps - 3
Crea la cuenta admin y el primer monitor
En el primer acceso, Uptime Kuma te pide crear el usuario administrador. Añade después un monitor (por ejemplo HTTP(S) sobre tu sitio) y configura un canal de notificación para recibir las alertas.
- 4
Protege el servidor para producción
Apunta un registro DNS A de YOUR_DOMAIN a SERVER_IP y sustituye la dirección del Caddyfile por tu dominio: Caddy obtendrá un certificado reconocido. Los puertos 80 y 443 deben permanecer abiertos y, si es posible, el puerto 22 limitado a tus IP.
Bashcd /opt/uptime-kuma nano Caddyfile # YOUR_DOMAIN { # reverse_proxy 127.0.0.1:3001 # } docker compose restart caddy
Casos de uso de Uptime Kuma
Vigilar tus sitios y APIs
Un monitor HTTP por sitio o endpoint crítico, con alerta por Telegram o correo en cuanto el código de respuesta sale del rango esperado.
Página de estado para tus clientes
Una agencia o un proveedor SaaS publica el estado de sus servicios en una página propia, y así evita responder a cada consulta por mensaje.
Controlar servidores y puertos internos
Ping a tus máquinas, TCP a una base de datos o a un servicio SSH, comprobación de un contenedor Docker: una vista única de la infraestructura.
Evitar caducidades de certificados
Sigues la fecha de caducidad de los certificados de tus dominios y recibes una alerta antes de que una renovación fallida deje un sitio fuera de servicio.
Preguntas frecuentes sobre Uptime Kuma
La receta configura Caddy con tls internal, que genera un certificado autofirmado para la dirección IP del servidor. El cifrado está activo, pero el navegador no puede verificar al emisor. Asocia un dominio al servidor y modifica el Caddyfile para obtener un certificado reconocido.
Más sobre Uptime Kuma
Ubicación de los archivos
Todo está en /opt/uptime-kuma: el script de instalación install-uptime-kuma.sh, el archivo docker-compose.yml y el Caddyfile. Caddy se ejecuta con network_mode: host y lee el Caddyfile en modo de solo lectura.
No vuelvas a ejecutar el script de instalación después de modificar el Caddyfile: lo reescribe con la dirección IP pública y perderías la configuración de tu dominio. Para aplicar un cambio, usa docker compose restart caddy.
Pasar de una IP a un dominio
De forma predeterminada, el Caddyfile contiene https://IP_PUBLIQUE:443 con tls internal, de ahí el certificado autofirmado. Si sustituyes esa línea por un nombre de dominio y eliminas tls internal, Caddy solicita y renueva por sí solo un certificado público. El DNS ya debe apuntar al servidor; de lo contrario, la solicitud falla.
Copias de seguridad
Los datos de Uptime Kuma se guardan en el volumen Docker kuma_data. Lo más seguro es detener el contenedor mientras se hace la copia y luego archivarlo.
Bashcd /opt/uptime-kuma docker compose stop uptime-kuma docker volume ls | grep kuma_data docker run --rm -v uptime-kuma_kuma_data:/data -v $(pwd):/backup alpine \ tar czf /backup/kuma-backup.tar.gz -C /data . docker compose start uptime-kuma
El nombre exacto del volumen depende de la carpeta del proyecto; compruébalo con el comando docker volume ls. Después, copia el archivo comprimido fuera del servidor. Un snapshot del VPS es un buen complemento.
Actualizaciones
La imagen usa la etiqueta 2, que sigue las versiones 2.x. Para obtener la última versión, haz una copia de seguridad y ejecuta:
Bashcd /opt/uptime-kuma docker compose pull docker compose up -d
Dónde colocar la monitorización
Un monitor alojado en el mismo servidor que vigila no te avisa si ese servidor se apaga por completo. Para los servicios importantes, instala Uptime Kuma en un VPS distinto, por ejemplo en la otra ubicación (París o Fráncfort). Consulta nuestros tutoriales para profundizar.

