# uptime-kuma | Louis Lam | Knowledge Base | Instagit

A fancy self-hosted monitoring tool

GitHub Stars: 83.4k

Repository: https://github.com/louislam/uptime-kuma

---

## Articles

### [Uptime Kuma CSRF Protection and Origin Security: How It Works](/louislam/uptime-kuma/uptime-kuma-security-measures-csrf-origin-checks-implemented)

Discover how Uptime Kuma secures your monitoring with JWT authentication CSRF protection and origin security checks. Learn about its robust defense against web vulnerabilities.

- Tags: security
- Published: 2026-02-28

### [How Uptime Kuma's Multi-Language (i18n) System Works: A Technical Deep Dive](/louislam/uptime-kuma/how-uptime-kuma-multi-language-i18n-system-works)

Explore Uptime Kuma's technical i18n system. Discover how lazy loading and vue-i18n deliver dynamic translations efficiently, enhancing user experience.

- Tags: deep-dive
- Published: 2026-02-28

### [How Incident Reports Are Generated and Managed in Uptime Kuma](/louislam/uptime-kuma/how-incident-reports-generated-managed-uptime-kuma)

Discover how Uptime Kuma generates and manages incident reports using Socket.io events. Learn about create, edit, delete, resolve, and history features optimized for your status page.

- Tags: internals
- Published: 2026-02-28

### [Uptime Kuma Uptime Calculator: How It Computes Uptime Percentages from Heartbeat Data](/louislam/uptime-kuma/uptime-kuma-uptime-calculator-computes-uptime-percentages)

Learn how the Uptime Kuma uptime calculator computes percentages by aggregating heartbeat data into minutely, hourly, and daily buckets. Understand your service availability.

- Tags: deep-dive
- Published: 2026-02-28

### [How Uptime Kuma Handles Notification Retry Logic and Queuing](/louislam/uptime-kuma/how-uptime-kuma-notification-system-handles-retry-logic-queuing)

Discover how Uptime Kuma's notification system manages retries and queuing. Learn about provider-specific logic and the absence of a central queue for reliable alerts.

- Tags: internals
- Published: 2026-02-28

### [How to Create a Custom Monitor Type Plugin for Uptime Kuma](/louislam/uptime-kuma/how-to-create-custom-monitor-type-plugin-uptime-kuma)

Learn how to create a custom monitor type plugin for Uptime Kuma. Extend the MonitorType class and register your plugin to add new monitoring capabilities.

- Tags: how-to-guide
- Published: 2026-02-28

### [How to Configure Certificate Expiry Monitoring in Uptime Kuma](/louislam/uptime-kuma/how-uptime-kuma-certificate-expiry-monitoring-feature-configured)

Learn how to configure certificate expiry monitoring in Uptime Kuma. Set global thresholds, enable notifications, and display remaining days on status pages for proactive alerts.

- Tags: how-to-guide
- Published: 2026-02-28

### [Docker Container Monitoring in Uptime Kuma: Architecture and Implementation Guide](/louislam/uptime-kuma/how-uptime-kuma-docker-container-monitoring-functions)

Learn how Uptime Kuma monitors Docker containers by connecting to the Docker daemon and using the Docker API to translate container health into UP, DOWN, or PENDING states.

- Tags: architecture
- Published: 2026-02-28

### [How Monitor Groups Organize Monitors in Uptime Kuma: Database Design and Implementation](/louislam/uptime-kuma/how-uptime-kuma-monitor-groups-utilized-organizing-monitors)

Discover how Uptime Kuma organizes monitors with monitor groups using a many-to-many database relationship and a special group monitor type. Understand the database design and implementation for efficient monitoring.

- Tags: internals
- Published: 2026-02-28

### [How API Authentication and Rate Limiting Work in Uptime Kuma](/louislam/uptime-kuma/how-uptime-kuma-api-authentication-rate-limiting-work)

Discover how Uptime Kuma secures its API with keys and rate limiting. Protect your service from abuse with effective authentication strategies.

- Tags: internals
- Published: 2026-02-28

### [How Uptime Kuma Exposes Prometheus Metrics: A Complete Technical Guide](/louislam/uptime-kuma/how-uptime-kuma-exposes-prometheus-metrics)

Learn how Uptime Kuma exposes Prometheus metrics via its built-in exporter. Discover the /metrics endpoint and understand monitor gauges in this technical guide.

- Tags: deep-dive
- Published: 2026-02-28

### [How Maintenance Windows Are Implemented in Uptime Kuma and How They Affect Monitoring](/louislam/uptime-kuma/how-uptime-kuma-maintenance-windows-implemented-affect-monitoring)

Learn how Uptime Kuma maintenance windows silence alerts and exclude downtime from uptime calculations. Discover database-backed scheduling and cron job implementation for effective monitoring management.

- Tags: internals
- Published: 2026-02-28

### [How the Uptime Kuma Push Monitor Type Works for External Check-Ins](/louislam/uptime-kuma/how-uptime-kuma-push-monitor-type-works-external-checkins)

Learn how Uptime Kuma push monitors allow external services to self-report health status via HTTP GET requests for passive monitoring. Features custom messages and latency tracking.

- Tags: internals
- Published: 2026-02-28

### [Uptime Kuma Status Page Architecture: Full-Stack Server-Rendered Design with Real-Time Updates](/louislam/uptime-kuma/uptime-kuma-status-page-system-architecture)

Explore the Uptime Kuma status page architecture. Discover its four-layer server-rendered design with embedded JSON for fast Vue hydration and real-time Socket.IO updates.

- Tags: architecture
- Published: 2026-02-28

### [How Proxy Support Functions in Uptime Kuma Monitors: HTTP, HTTPS, and SOCKS Implementation](/louislam/uptime-kuma/how-does-proxy-support-function-uptime-kuma-monitors)

Learn how Uptime Kuma implements proxy support for HTTP, HTTPS, and SOCKS monitors. Discover how traffic is routed through your configurations for enhanced monitoring.

- Tags: deep-dive
- Published: 2026-02-28

### [How to Configure SSL/TLS for Uptime Kuma: Native HTTPS and Reverse Proxy Methods](/louislam/uptime-kuma/how-to-configure-ssl-tls-uptime-kuma-server)

Secure your Uptime Kuma monitoring with native HTTPS or a reverse proxy. This guide explains SSL/TLS configuration for enhanced security and accessibility.

- Tags: how-to-guide
- Published: 2026-02-28

### [How Uptime Kuma Implements 2FA Authentication: A Complete Technical Guide to TOTP](/louislam/uptime-kuma/uptime-kuma-2fa-authentication-system-implementation)

Uptime Kuma implements 2FA authentication with TOTP via WebSocket. Explore the technical details of its secure token verification and secret storage.

- Tags: deep-dive
- Published: 2026-02-28

### [How the Uptime Kuma Database Layer Manages SQLite and Optional MySQL/MariaDB](/louislam/uptime-kuma/how-uptime-kuma-database-layer-manages-sqlite-mysql-mariadb)

Discover how Uptime Kuma's database layer expertly handles SQLite and optional MySQL/MariaDB using Knex and RedBean-Node for robust data management.

- Tags: internals
- Published: 2026-02-28

### [Uptime Kuma Monitor Types: Complete Implementation Guide and Architecture](/louislam/uptime-kuma/uptime-kuma-monitor-types-implementation)

Explore Uptime Kuma monitor types and their implementation. Discover how Uptime Kuma supports over 30 monitors including HTTP, databases, and Playwright for robust system monitoring.

- Tags: deep-dive
- Published: 2026-02-28

### [How the Uptime Kuma API Router Handles WebSocket Real-Time Updates](/louislam/uptime-kuma/how-uptime-kuma-api-router-handles-websocket-real-time-updates)

Discover how the Uptime Kuma API router leverages Socket.IO for real-time WebSocket updates, efficiently synchronizing live UI with state persistence.

- Tags: internals
- Published: 2026-02-28

### [How to Add a Custom Notification Provider to Uptime Kuma](/louislam/uptime-kuma/how-to-add-custom-notification-provider-uptime-kuma)

Easily add custom notification providers to Uptime Kuma. Extend the NotificationProvider class and register your service for enhanced alerting. Learn how now.

- Tags: how-to-guide
- Published: 2026-02-28

### [How the Uptime Kuma Heartbeat System Tracks Monitor Status: A Technical Deep Dive](/louislam/uptime-kuma/how-does-uptime-kuma-heartbeat-system-track-monitor-status)

Discover how Uptime Kuma heartbeat tracks monitor status using database records, retry logic, state flags, and real-time WebSocket broadcasts. Learn the technical details.

- Tags: deep-dive
- Published: 2026-02-28

### [How the Uptime Kuma Monitoring System Works Internally: Architecture and Code Deep Dive](/louislam/uptime-kuma/how-does-uptime-kuma-monitoring-system-work-internally)

Discover the internal workings of Uptime Kuma. Learn how this Node.js monitoring system uses SQLite, Socket.io, and croner for efficient health checks and real-time alerts.

- Tags: internals
- Published: 2026-02-28