Home

CheckMK RAW - Wiki

Documentación completa para desplegar y configurar CheckMK RAW con Docker.

📋 Índice

🚀 Despliegue

• Traefik - Despliegue con Traefik (proxy inverso + SSL automático)
• NPM - Despliegue con Nginx Proxy Manager

⚙️ Configuración

• Configuración Inicial - Primer acceso, cambiar contraseña, site
• Monitorización - Añadir hosts, agentes, SNMP, dashboards

💾 Mantenimiento

• Backup y Restauración - Backups automáticos, restauración
• Actualización - Actualizar CheckMK, rollback
• Solución de Problemas - Diagnóstico, errores comunes

---

🎯 Características

• Sistema de monitorización IT profesional
• Agentes: Linux, Windows, Docker, SNMP
• Dashboards: Visualización en tiempo real
• Alertas: Email, SMS, Slack, Teams
• Multi-sitio: Gestión centralizada
• Gratuito: CheckMK RAW Edition (GPLv2)

---

⚡ Quick Start

Requisitos

• Docker Engine
• Portainer (recomendado)
• Red proxy creada
• Dominio configurado

Generar Contraseña

ANTES de desplegar, genera 1 contraseña segura:

# CMK_PASSWORD (usuario cmkadmin)
openssl rand -base64 32

Despliegue Básico

1. Crea el stack en Portainer con Git Repository:

   • URL: https://git.ictiberia.com/groales/checkmk
   • Compose path: docker-compose.yml

2. Añade variables de entorno:

   CMK_PASSWORD=password_generado
   DOMAIN_HOST=checkmk.tudominio.com

3. Deploy y espera 2-3 minutos (CheckMK inicializa el site)

4. Accede según tu proxy inverso:

   • Con Traefik: https://checkmk.tudominio.com/monitoring/
   • Con NPM: Configura proxy host primero (ver NPM)

5. Login:

   • Usuario: cmkadmin
   • Contraseña: La que configuraste en CMK_PASSWORD

---

📦 Arquitectura

Stack Docker

┌─────────────────────┐
│   Traefik / NPM     │ ← Puerto 443 (HTTPS)
└──────────┬──────────┘
           │
┌──────────▼──────────┐
│      CheckMK        │ ← Puerto 5000 (interno)
│  (check-mk-raw)     │
└──────────┬──────────┘
           │
┌──────────▼──────────┐
│  checkmk_data       │ ← Volumen persistente
│  (/omd/sites)       │
└─────────────────────┘

Componentes

• CheckMK: Aplicación web (puerto 5000)
• Site: Instancia de monitorización (ID: monitoring)
• Proxy: Traefik o NPM para HTTPS

Volúmenes

• checkmk_data: Configuración, históricos, RRD databases

---

🔗 Próximos Pasos

1. Elige tu modo de despliegue:

   • Traefik - Recomendado para múltiples servicios
   • NPM - Más simple para configurar

2. Configura CheckMK:

   • Configuración Inicial - Cambiar contraseña, timezone
   • Monitorización - Añadir tus primeros hosts

3. Automatiza backups:

   • Backup y Restauración - Scripts de backup automáticos

---

📚 Recursos Externos

• CheckMK Documentación Oficial
• CheckMK Community
• CheckMK GitHub