groales/uptime-kuma
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Page: Configuración Inicial
Pages
Actualización Backup y Restauración Configuración Inicial Home Monitorización NPM Solución de Problemas Status Pages Traefik
Clone
Configuración Inicial
groales edited this page 2025-12-05 11:04:10 +01:00
Table of Contents

Configuración Inicial

Esta guía cubre la configuración inicial de Uptime Kuma después del primer despliegue.

1. Crear Cuenta Administrador

Al acceder por primera vez a https://uptime.example.com, verás la pantalla de creación de cuenta.

⚠️ IMPORTANTE: No hay usuario por defecto. El primer usuario que crees será administrador.

Pasos

  1. Username: Nombre de usuario para login (ejemplo: admin, tu_usuario)
  2. Password: Contraseña segura (mínimo 6 caracteres, recomendado: 16+ con símbolos)
  3. Click en Create

Acceso posterior:

  • URL: https://uptime.example.com
  • Usuario: El username que creaste
  • Password: La contraseña que creaste

2. Configurar Idioma

Por defecto, Uptime Kuma está en inglés. Cambiarlo a español:

  1. Click en el icono de perfil (esquina superior derecha)
  2. Settings → Appearance
  3. Language: Selecciona Español (o tu idioma preferido)
  4. La interfaz se recargará en español

3. Configurar Notificaciones

Uptime Kuma soporta 90+ canales de notificación. Configurar al menos uno es altamente recomendado.

Telegram (Recomendado)

Ventajas: Gratuito, instantáneo, fácil configuración.

Paso 1: Crear bot

  1. Abre Telegram y busca @BotFather
  2. Envía /newbot
  3. Elige nombre del bot (ejemplo: "Uptime Monitor")
  4. Elige username (ejemplo: uptime_monitor_bot)
  5. BotFather te dará un bot token: 
    123456789:ABCdefGHIjklMNOpqrsTUVwxyz
    ⚠️ Guardar este token.

Paso 2: Obtener Chat ID

  1. Busca @userinfobot en Telegram
  2. Envía /start
  3. El bot responderá con tu Chat ID: 
    Id: 123456789
    Si es un grupo, el Chat ID comienza con - (ejemplo: -987654321).

Paso 3: Configurar en Uptime Kuma

  1. Settings → Notifications
  2. Click en Setup Notification
  3. Notification Type: Telegram
  4. Configurar:
    • Friendly Name: Telegram Principal
    • Bot Token: Pegar el token de BotFather
    • Chat ID: Pegar tu Chat ID (o del grupo)
  5. Click en Test → Deberías recibir mensaje en Telegram
  6. Save

Discord

  1. En Discord, ve al canal donde quieres recibir notificaciones
  2. Configuración del canal → Integraciones → Webhooks
  3. Crear Webhook
  4. Copiar URL del Webhook: 
    https://discord.com/api/webhooks/123456789/abcdefg...

En Uptime Kuma:

  1. Settings → Notifications → Setup Notification
  2. Notification Type: Discord
  3. Webhook URL: Pegar URL
  4. Test → Deberías ver mensaje en Discord
  5. Save

Email (SMTP)

Ejemplo con Gmail:

  1. Settings → Notifications → Setup Notification

  2. Notification Type: Email (SMTP)

  3. Configurar:

    • Friendly Name: Email Alerts
    • Hostname: smtp.gmail.com
    • Port: 587
    • Security: TLS
    • Username: tu_email@gmail.com
    • Password: App Password (no contraseña de cuenta)
    • From Email: tu_email@gmail.com
    • To Email: destino@example.com

  4. Test → Verificar que llega email

  5. Save

Generar App Password en Gmail

  1. Ve a https://myaccount.google.com/security
  2. 2-Step Verification debe estar habilitada
  3. App passwords → Generar nueva
  4. Selecciona Mail y dispositivo Other
  5. Copiar password generado (16 caracteres)
  6. Usar ese password en Uptime Kuma

Otros Canales

Uptime Kuma soporta:

  • Slack: Requiere Incoming Webhook
  • Microsoft Teams: Requiere Incoming Webhook
  • PagerDuty: Para equipos de guardia 24/7
  • Gotify: Notificaciones push self-hosted
  • Webhooks: Integración personalizada (envía JSON a tu API)

4. Configurar 2FA (Autenticación de Dos Factores)

⚠️ Altamente recomendado para seguridad.

Pasos

  1. Settings → Security
  2. Two Factor Authentication → Setup
  3. Escanear código QR con app:
    • Google Authenticator (Android/iOS)
    • Authy (Android/iOS/Desktop)
    • Microsoft Authenticator (Android/iOS)
  4. Ingresar código de 6 dígitos generado por la app
  5. Enable

Próximo login:

  • Ingresar usuario y password
  • Ingresar código 2FA de la app

⚠️ Guardar códigos de recuperación en lugar seguro.

5. Configurar Zona Horaria

Para que los logs y gráficos muestren hora correcta:

  1. Settings → General
  2. Timezone: Selecciona tu zona horaria (ejemplo: Europe/Madrid, America/Mexico_City)
  3. Save

6. Configurar Retención de Datos

Uptime Kuma guarda historial de checks. Configurar cuánto tiempo mantener:

  1. Settings → General
  2. Data Retention:
    • Keep Data: 180 días (6 meses recomendado)
    • Si tienes muchos monitores: reducir a 90 o 60 días
  3. Save

Base de datos SQLite crece con el tiempo. Retención baja = menor tamaño.

7. Agregar Usuarios Adicionales (Opcional)

Si trabajas en equipo, puedes crear usuarios adicionales:

  1. Settings → Users
  2. Click en Add User
  3. Configurar:
    • Username: Nombre de usuario
    • Password: Contraseña temporal (el usuario la puede cambiar)
    • Role:
      • Admin: Acceso completo
      • User: Solo ver monitores (no editar configuración)
  4. Save

El nuevo usuario puede:

  • Login en https://uptime.example.com
  • Cambiar su password en Settings → Security

8. Configurar Status Page (Opcional)

Si quieres página pública para mostrar estado de servicios:

Consulta Status Pages para guía completa.

Configuración Completa ✅

Ya tienes Uptime Kuma configurada:

  • ✅ Cuenta administrador creada
  • ✅ Idioma configurado
  • ✅ Notificaciones configuradas
  • ✅ 2FA habilitada (recomendado)
  • ✅ Zona horaria correcta

Siguiente Paso

Continúa con Monitorización para añadir tus primeros monitores.

Navegación

🏠 Home

🚀 Despliegue

⚙️ Configuración

🔧 Mantenimiento