Checkmate en Docker: Crea tu propia Página de Estado y Monitor de Uptime. Alternativa a UptimeKuma en Docker🐳🔒

- marzo 05, 2026

Checkmate en Docker: Crea tu propia Página de Estado y Monitor de Uptime 🐳🔒

1. Presentación y Objetivo

El objetivo de este proyecto es implementar un sistema de alerta temprana en nuestra infraestructura. Queremos una herramienta que "vigile" por nosotros y que nos proporcione una página de estado visual para confirmar que todos nuestros servicios (Seafile, FileBrowser, Komodo, etc.) están operativos al 100%.

2. Introducción a Checkmate y Despliegue con Docker

Checkmate destaca por su bajísimo consumo de recursos y su interfaz intuitiva. Al correr bajo Docker, podemos integrarlo fácilmente en nuestro stack de gestión, permitiéndole comunicarse con otros contenedores para verificar su salud interna o externa mediante peticiones HTTP, TCP o Ping.

3. Preparación y Configuración de Docker Compose

Para que Checkmate funcione, mapearemos el puerto 3000 y definiremos un volumen para que nuestras configuraciones y el historial de uptime no se pierdan al reiniciar el contenedor.

YAML

services:
  checkmate:
    image: ghcr.io/bluewave-labs/checkmate-backend-mono:latest
    container_name: checkmate
    restart: unless-stopped
    ports:
      - "52345:52345"
    environment:
      - CLIENT_HOST=http://IP-HOST-DOCKER:52345
      - UPTIME_APP_CLIENT_HOST=http://IP-HOST-DOCKER:52345
      - UPTIME_APP_API_BASE_URL=http://IP-HOST-DOCKER:52345/api/v1
      - UPTIME_ALLOWED_ORIGINS=http://IP-HOST-DOCKER:52345
      - UPTIME_APP_PUBLIC_ASSETS_URL=http://IP-HOST-DOCKER:52345/uploads
      - UPTIME_APP_UPLOAD_DIR=/app/uploads
      - JWT_SECRET=${JWT_SECRET}
      - DB_CONNECTION_STRING=mongodb://mongodb:27017/checkmate
    volumes:
      - ./uploads:/app/uploads
      - /var/run/docker.sock:/var/run/docker.sock:ro
    depends_on:
      - mongodb

  mongodb:
    image: mongo:6
    container_name: checkmate-mongo
    restart: unless-stopped
    command: ["mongod", "--quiet"]
    volumes:
      - ./mongo:/data/db

4. Startup del Contenedor

Lanzamos el despliegue con: docker-compose up -d En pocos segundos, el motor de monitorización estará listo para empezar a recibir nuestras reglas de vigilancia.

5. Acceso Inicial y Configuración

Entramos en http://IP-DE-TU-SERVIDOR:3000. Lo primero será crear la cuenta de administrador. Una vez dentro, la interfaz nos guiará para añadir nuestro primer "Check". Solo necesitamos la URL o la IP del servicio que queremos vigilar y el intervalo de tiempo entre cada comprobación.

6. Main Features

6.1 Management de la utilidad del contenedor

Checkmate nos permite organizar nuestros monitores por categorías. Podemos ver gráficas de tiempo de respuesta (latencia) y el porcentaje de disponibilidad histórico, lo cual es vital para detectar problemas intermitentes en nuestra conexión o hardware.

6.2 Configuración Avanzada

La potencia real viene con las Notificaciones. Puedes configurar webhooks para que Checkmate te envíe un mensaje a Telegram o Discord en el momento exacto en que un servicio caiga, permitiéndote reaccionar antes de que los usuarios (o tú mismo) noten el problema.

7. Utility Summary y Community

Checkmate es la definición de "instalar y olvidar". Es fiable, estético y cumple su función sin complicaciones innecesarias. Al ser una herramienta muy valorada en la comunidad self-hosted, su desarrollo es constante, añadiendo siempre nuevos métodos de verificación y sistemas de alerta.

Repositorio en Github: https://github.com/bluewave-labs/checkmate

Mi repo: https://github.com/JLalib/docker-checkmate

Guía completa paso a paso en YouTube

🔗 Enlaces de Interés y Apoyo al Canal 🔗

Si te ha servido este contenido, apoya mi canal suscribiéndote: https://bit.ly/3NKeL8K
Puedes invitarme a un Ko-fi: https://ko-fi.com/genbyte
Mail de contacto: genbyte@proton.me

Buscar este blog

Genbyte