Uptime Kuma self-hosted: instálalo en tu VPS con HTTPS
Tutorial · · 6 min de lectura
Uptime Kuma es el monitor de disponibilidad auto-alojado más popular: comprueba tus webs, APIs, puertos o servidores cada pocos segundos, te avisa por Telegram, Discord, email y decenas de canales más, y publica páginas de estado para tus clientes. Todo desde una interfaz muy cuidada y sin pagar por número de monitores.
En esta guía lo instalas en tu VPS con la plantilla de SecuryBlack, con HTTPS y con sus datos a salvo entre actualizaciones. Al final verás también su gran limitación y cómo cubrirla.
Qué necesitas
- Un VPS con Docker. Uptime Kuma es ligero: con 512 MB de RAM libres va bien para decenas de monitores.
- El servidor conectado a SecuryBlack con CromoForge, el agente que despliega las apps.
- Un subdominio, por ejemplo
status.tudominio.com. - Los puertos 80 y 443 libres para el proxy HTTPS.
Paso 1: apunta el subdominio al servidor
Crea un registro A con el nombre status y la IP pública del VPS (y AAAA si tienes IPv6). Comprueba que ya resuelve antes de seguir:
dig +short status.tudominio.com
Paso 2: crea la app desde la plantilla
En el panel, ve a Apps → Nueva app → Plantilla, elige Uptime Kuma y rellena nombre, servidor y dominio. Si ya tienes sesión, este enlace abre la plantilla de Uptime Kuma elegida.
Paso 3: qué hace la plantilla
- Usa la versión 2 con SQLite. Uptime Kuma 2 pregunta en el primer arranque qué base de datos usar. La plantilla ya elige SQLite, que es lo más sencillo y suficiente para la gran mayoría de instalaciones, así que entras directamente a crear tu cuenta.
- Guarda los datos en un volumen. Monitores, historial, notificaciones y páginas de estado viven en
/app/data, en un volumen de Docker que se conserva entre despliegues. - Sirve la app con HTTPS. Uptime Kuma solo escucha en
127.0.0.1y un proxy Caddy delante pide y renueva el certificado. Los websockets de la interfaz funcionan a través del proxy sin configurar nada.
Paso 4: crea la cuenta de administrador ya
Abre https://status.tudominio.com. Uptime Kuma te pide crear un usuario: la primera cuenta que se crea es la de administrador. Hazlo nada más terminar el despliegue. Después, en Settings → Security, puedes activar la autenticación en dos pasos.
Paso 5: tus primeros monitores
Pulsa Add New Monitor y prueba con:
- HTTP(s) contra tu web principal, con un intervalo de 60 segundos.
- HTTP(s) - Keyword para comprobar que la página contiene un texto concreto, no solo que responde.
- TCP Port contra un servicio que no sea web, como tu servidor de correo.
En Settings → Notifications configura un canal (Telegram es el más rápido de montar) y márcalo como predeterminado. Si quieres enseñar el estado a tus clientes, crea una Status Page y añade los monitores que quieras hacer públicos.
La limitación: ¿quién vigila al vigilante?
Uptime Kuma corre en tu servidor. Si ese VPS se cae, se queda sin red o se llena el disco, Uptime Kuma cae con él y no te avisa de nada. Es el problema clásico de vigilar desde dentro.
Hay dos formas de cubrirlo:
- Ponerlo en un servidor distinto del que vigila, en otro proveedor si puede ser.
- Vigilarlo desde fuera. Un monitor de uptime de SecuryBlack contra
https://status.tudominio.comcomprueba desde fuera de tu servidor que tanto Uptime Kuma como el VPS responden. Si quieres comparar enfoques, tienes la comparativa entre UptimeRobot, Uptime Kuma y SecuryBlack.
Actualizar y mantener Uptime Kuma
- Actualizar: pulsa Desplegar en la app. Se descarga la última versión 2 de Uptime Kuma; los monitores y su historial siguen en el volumen.
- Vigilar el disco: con muchos monitores e intervalos cortos, el historial crece. En Settings → Monitor History decides cuántos días guardar, y el agente de monitorización del servidor te avisa si el disco se llena.
- Borrarlo: desde Ajustes → Zona peligrosa. Al borrar la app se borra también su volumen, con todos los monitores e historial.
Conclusión
Uptime Kuma es una forma excelente de tener monitorización y páginas de estado sin cuotas, y con la plantilla está listo en minutos y con HTTPS. Combínalo con una comprobación externa y tendrás cubierto también el día que se caiga el propio servidor. Crea tu cuenta en SecuryBlack y pruébalo.