3
Home
groales edited this page 2025-12-05 11:46:27 +01:00

Wiki de Uptime Kuma

¡Bienvenido a la documentación completa de Uptime Kuma! Esta wiki te guiará en la instalación, configuración y uso de tu sistema de monitorización self-hosted.


📋 Índice

  1. Home - Esta página
  2. Despliegue con Traefik - Configuración con Traefik como proxy inverso
  3. Despliegue con NPM - Configuración con Nginx Proxy Manager
  4. Configuración Inicial - Primer acceso, usuarios, notificaciones
  5. Monitorización - Añadir monitores (HTTP, TCP, Ping, DNS, Docker)
  6. Status Pages - Crear páginas de estado públicas
  7. Backup y Restauración - Proteger tus datos
  8. Actualización - Mantener Uptime Kuma actualizada
  9. Solución de Problemas - Resolver errores comunes

🚀 Quick Start

Despliegue rápido con CLI

# Clonar repositorio
git clone https://git.ictiberia.com/groales/uptime-kuma.git
cd uptime-kuma

# Configurar Traefik
cp docker-compose.override.traefik.yml.example docker-compose.override.yml
cp .env.example .env
nano .env  # Editar DOMAIN_HOST=uptime.example.com

# Desplegar
docker compose up -d

# Ver logs
docker compose logs -f uptime-kuma

Acceso: https://uptime.example.com


📦 ¿Qué es Uptime Kuma?

Uptime Kuma es una herramienta de monitorización self-hosted moderna y elegante, alternativa a servicios como UptimeRobot o StatusCake.

Características principales

  • Monitorización multi-protocolo: HTTP(s), TCP, Ping, DNS, Docker, Steam Game Server, etc.
  • 90+ canales de notificación: Telegram, Discord, Slack, Email, Gotify, PagerDuty, Webhooks, y más
  • Status Pages públicas: Comparte el estado de tus servicios con usuarios/clientes
  • Mapeo de dependencias: Visualiza relaciones entre servicios
  • Monitorización de certificados SSL: Alertas de expiración
  • Multi-idioma: Interfaz en español y otros idiomas
  • 2FA: Autenticación de dos factores
  • Sin base de datos externa: SQLite embebida (sin PostgreSQL/MySQL necesarios)

🏗️ Arquitectura del Stack

┌─────────────────────────────────────────────────┐
│  Internet                                       │
│  (https://uptime.example.com)                   │
└────────────────┬────────────────────────────────┘
                 │
        ┌────────▼─────────┐
        │  Traefik / NPM   │  ← Proxy inverso con SSL
        │  (Puerto 443)    │
        └────────┬─────────┘
                 │
        ┌────────▼─────────┐
        │  Uptime Kuma     │  ← Aplicación
        │  (Puerto 3001)   │
        └────────┬─────────┘
                 │
        ┌────────▼─────────┐
        │  SQLite          │  ← Base de datos embebida
        │  (kuma.db)       │
        └──────────────────┘

Componentes:

  • Uptime Kuma: Aplicación principal (imagen louislam/uptime-kuma:2)
  • SQLite: Base de datos embebida en /app/data/kuma.db
  • Traefik/NPM: Proxy inverso para SSL y acceso público

📚 Próximos Pasos

  1. Nuevo usuario: Comienza con Configuración Inicial
  2. Añadir monitorización: Ve a Monitorización
  3. Crear status page pública: Consulta Status Pages
  4. Problemas: Revisa Solución de Problemas

🔗 Enlaces Útiles