Skip to content

Alvarito1983/nexus-pulse

Repository files navigation

NEXUS Pulse logo

NEXUS Pulse

A lightweight, beautiful uptime & health monitoring tool — for Docker containers and network services.

License MIT Docker ready docker pulls Node.js 24 React 18

Docker Hub · Report Bug


✨ Features

  • 🐳 Container monitoring — real-time status of all Docker containers grouped by state (Running / Stopped / Other)
  • 🌐 Web monitors — HTTP/HTTPS checks with response time, status code and SSL certificate expiry
  • 🔌 TCP monitors — port availability checks for any host and port
  • 🔍 DNS monitors — DNS resolution checks with optional IP validation
  • 🗄️ Database monitors — connection checks for MySQL, PostgreSQL, Redis and MongoDB
  • 📡 API monitors — HTTP checks with custom headers, auth (Bearer / Basic) and expected status
  • 📊 Uptime history — visual 30-check history bar per monitor (green/red pixels)
  • 🔔 Telegram alerts — instant notifications when a monitor goes DOWN or recovers UP
  • 🌍 Full EN/ES i18n — English and Spanish UI
  • 📱 PWA — installable on mobile and desktop
  • 🔒 Multi-user — Admin and Viewer roles with session-based auth

Quickstart

docker run -d \
  --name nexus-pulse \
  -p 9092:3002 \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v pulse-data:/app/data \
  afraguas1983/nexus-pulse:latest

Or with Docker Compose (recommended):

git clone https://github.com/Alvarito1983/nexus-pulse.git
cd nexus-pulse
cp .env.example .env
docker compose up -d

Open http://localhost:9092 — default credentials: admin / admin


📸 Screenshots

Login Containers
Login Containers
Web monitors TCP monitors
Web TCP
DNS monitors Database monitors
DNS Database
API monitors History
API History

🗺️ Roadmap

v1.0.0 — Current ✅

  • Docker container monitoring with grouped view (Running / Stopped / Other)
  • Web (HTTP/HTTPS + SSL), TCP, DNS, Database and API monitors
  • Visual 30-check uptime history bar per monitor
  • Telegram notifications on state changes
  • EN/ES i18n
  • PWA support
  • Session-based auth with Admin/Viewer roles

v1.2.0 — Dark Premium redesign ✅

  • Complete UI overhaul — Dark Premium design language (Linear/Vercel aesthetic), blue accent #3b82f6
  • Unified layout with NEXUS ecosystem standard
  • Login: centered card with blue radial glow, fadeSlideUp animation
  • Sidebar: dark surface, Lucide icons, blue active state
  • TopBar: 56px, backdrop-filter: blur
  • Stat cards with semantic colors and skeleton loading
  • Shared components: Button, Badge, Card, Input, EmptyState, Skeleton, HistoryBar
  • Typography: Inter + JetBrains Mono
  • Version dynamic from package.json via __APP_VERSION__
  • Responsive: hamburger sidebar on mobile

v2.0.0 — NEXUS Ecosystem 🚀 (Q4 2026)

NEXUS Pulse is part of the NEXUS Ecosystem — a suite of modular, standalone Docker tools that integrate seamlessly when used together.

"Each tool works. Together, they think."

NEXUS Hub             — Unified dashboard, SSO, service registry  :9095
├── NEXUS             — Docker manager                             :9090  ✅ live
├── NEXUS Watcher     — Image update detection                     :9091  ✅ live
├── NEXUS Pulse       — Uptime & health monitoring                 :9092  ✅ live
├── NEXUS Security    — CVEs, SSL & audit                          :9093  🔜 coming
└── NEXUS Notify      — Unified alert routing                      :9094  🔜 coming

⚙️ Environment variables

Variable Default Description
ADMIN_USER admin Admin username
ADMIN_PASSWORD admin Admin password
POLL_INTERVAL 30 Container poll interval in seconds

Tech stack

  • Backend — Node.js 24, Express, Dockerode, node-cron
  • Frontend — React 18, Vite
  • Base imagenode:24-alpine
  • Auth — Session tokens, Admin/Viewer roles
  • Docker socket — always via tecnativa/docker-socket-proxy (never mounted directly)

License

MIT © Alvarito1983


Made with ☕ by Alvarito1983