Uptime Kuma is a self-hosted monitoring tool written in JavaScript that provides an alternative to commercial services like Uptime Robot. The project was created to fill a gap in the market for stable, self-hosted monitoring solutions after the creator found existing options like Statping to be unmaintained and unreliable. The tool is designed with a focus on user experience, featuring a fancy and reactive UI built with Vue 3 and Vite.js, and it leverages WebSocket communication through Socket.io instead of traditional REST APIs for real-time updates in a single-page application architecture.
The monitoring capabilities of Uptime Kuma are extensive, supporting multiple protocol types including HTTP(s), TCP, HTTP(s) Keyword matching, HTTP(s) JSON Query, WebSocket, Ping, DNS Record queries, Push notifications, Steam Game Server monitoring, and Docker Container monitoring. The tool checks service status at 20-second intervals and provides comprehensive notification support across over 90 different services including Telegram, Discord, Gotify, Slack, Pushover, and email via SMTP. Additional features include multiple status pages that can be mapped to specific domains, ping charts for visualizing response times, certificate information display, proxy support, and two-factor authentication for security.
Installation flexibility is a key strength of Uptime Kuma, with support for Docker Compose, direct Docker commands, and non-Docker deployment on major Linux distributions and Windows systems. The project is actively maintained and distributed through Docker Hub, making containerized deployment straightforward. The application runs on port 3001 and can be accessed through a web interface with support for multiple languages and both light and dark modes.
The repository demonstrates strong community engagement and active maintenance. GitGenius activity data shows a median issue and pull request response latency of zero hours with a mean of 4.6 hours, indicating rapid triage and response times. The project has accumulated 2067 tracked issues and pull requests, with feature requests being the most common category at 842 items, followed by help requests at 721 and bug reports at 411. The core contributor CommanderStorm leads activity with 5849 tracked events, while the original creator louislam maintains 1271 events, and chakflying contributes 141 events. The project's contributor base overlaps with major repositories including Microsoft's VSCode and TypeScript projects as well as the Rust language repository, suggesting it attracts developers from significant open-source ecosystems.
The project actively encourages community contributions through pull requests, beta testing, bug reporting, feature requests, and translation work via Weblate. The creator has established clear contribution guidelines and maintains a wiki with detailed installation and update instructions. Uptime Kuma is supported through both GitHub Sponsors and OpenCollective, with a live demo available at demo.kuma.pet for users to test the functionality before deployment.
