Uptime Kuma: monitorización de disponibilidad en tu propio servidor
Un monitor en tu propio servidor que comprueba tus sitios y servicios cada minuto y te avisa en cuanto uno de ellos deja de responder.
Sobre Uptime Kuma
Uptime Kuma es una herramienta de monitorización de código abierto que empezó el desarrollador Louis Lam y que hoy es uno de los proyectos autoalojados con más estrellas en GitHub. Comprueba si las cosas responden: sitios web por HTTP(S), palabras clave en una página, puertos TCP, ping, registros DNS, bases de datos y más.
Cuando una comprobación falla, envía una notificación por cualquiera de las decenas de canales compatibles, como Telegram, Discord, Slack, correo electrónico y webhooks. También registra los tiempos de respuesta, avisa antes de que caduquen los certificados TLS y te permite crear páginas de estado públicas para tus clientes.
La gente lo instala en su propio servidor porque es ligero, gratuito y tiene una interfaz limpia que se configura en minutos. Ejecutarlo en un servidor aparte es el detalle clave: un monitor que vive en la misma máquina que tu sitio no puede avisarte cuando esa máquina se cae.
Para qué se usa
Alertas cuando un sitio se cae
Comprueba tu sitio web y tu API cada minuto y recibe un mensaje por Telegram o por correo en cuanto dejen de responder.
Avisos de caducidad de certificados
Recibe un recordatorio días antes de que caduque un certificado HTTPS, en lugar de enterarte por tus clientes.
Una página de estado pública
Muestra a tus clientes el estado actual de tus servicios en una página que controlas tú.
Después del pedido
El primer arranque del servidor instala Uptime Kuma y abre el puerto 3001 en el firewall, así que el monitor está accesible en http://direccion-de-tu-servidor:3001/. En la primera visita creas la cuenta de administrador, así que abre la dirección en cuanto el servidor esté listo. Después añade tu primer monitor y conecta un canal de notificaciones.
Dónde ejecutarlo
Uptime Kuma comprueba desde donde se ejecuta. Un monitor en el mismo servidor que los servicios que vigila se cae con ellos y no puede avisarte, así que tenlo en un servidor distinto del que monitoriza.
Tu propio dominio y HTTPS para Uptime Kuma
Recién instalado, Uptime Kuma responde en la dirección IP del servidor por HTTP sin cifrar. Para darle un nombre como status.example.com con certificado, crea en tu DNS un registro A para ese nombre que apunte a la dirección IPv4 del servidor y pon Caddy delante: Caddy obtiene por sí solo un certificado gratuito de Let's Encrypt y lo renueva. Los comandos de abajo son para Ubuntu 24.04, el sistema de nuestros servidores de aplicaciones.
En el panel, abre los puertos TCP 80 y 443 en el firewall del servidor: Caddy los necesita para obtener el certificado de Let's Encrypt y para servir el sitio.
apt install -y caddy
cat > /etc/caddy/Caddyfile <<'EOF'
status.example.com {
reverse_proxy 127.0.0.1:3001
}
EOF
systemctl reload caddyCon un dominio delante, puedes compartir las páginas de estado de Uptime Kuma con tus clientes: crea una página de estado, elige qué monitores muestra y comparte https://status.example.com/status/your-page. También puedes asignar el dominio a la propia página de estado en sus ajustes.
Cuando el dominio funcione, ya nadie necesita el puerto 3001 directo: en /opt/uptime-kuma/compose.yml cambia "3001:…" por "127.0.0.1:3001:…", ejecuta docker compose up -d y quita el puerto 3001 del firewall. A partir de ahí, Uptime Kuma solo es accesible por HTTPS.
Actualizar Uptime Kuma
Las imágenes de /opt/uptime-kuma/compose.yml están fijadas a versiones exactas, así que un simple docker compose pull vuelve a descargar la misma versión. Para actualizar, cambia la versión en la línea image: por la que quieras (lee antes las notas de la versión), descarga la imagen y vuelve a crear los contenedores. Los datos están en volúmenes de Docker y se conservan.
cd /opt/uptime-kuma
nano compose.yml # the new version in the image: line
docker compose pull
docker compose up -dCopias de seguridad de Uptime Kuma
En el panel puedes activar copias de seguridad diarias de todo el servidor (+20 % del precio del plan; se guardan las 7 últimas) y restaurar el servidor desde cualquiera de ellas. Aun así, conviene tener una copia de los datos de la propia aplicación en un archivo: se puede llevar a otro servidor o restaurar sin revertir todo lo demás.
Los monitores, los ajustes de notificaciones y el historial de comprobaciones están en el volumen uptime-kuma_uptime_kuma (/app/data). Detén la aplicación un momento para que el archivo de la base de datos se copie en un estado coherente:
cd /opt/uptime-kuma && docker compose stop
docker run --rm -v uptime-kuma_uptime_kuma:/data -v /root:/backup alpine \
tar czf /backup/uptime-kuma-$(date +%F).tgz -C /data .
docker compose startCómo funciona
- Elige Uptime Kuma en la página de pedido del servidor y escoge un plan con memoria suficiente.
- La aplicación se instala en el servidor en su primer arranque, normalmente en pocos minutos.
- Abre el servidor en tu panel: ahí tienes la dirección y los datos de acceso.