Uptime Kuma logo

Uptime Kuma

Self-hosted uptime monitoring with a fancy reactive interface

Easy-to-use self-hosted monitoring tool for tracking uptime across HTTP, TCP, ping, DNS, Docker containers, and more with 90+ notification integrations.

Uptime Kuma banner

Overview

Overview

Uptime Kuma is a self-hosted monitoring solution designed for teams and individuals who need reliable uptime tracking without depending on third-party services. Built with Vue 3 and powered by WebSocket communication, it delivers a responsive, real-time interface for monitoring infrastructure health.

Capabilities

Monitor diverse endpoints including HTTP(s), TCP ports, ping targets, DNS records, Docker containers, and Steam game servers. Track keyword presence, query JSON responses, or receive push-based health checks. The platform supports 20-second check intervals and displays certificate information, ping charts, and historical data through an intuitive dashboard.

Notifications reach your team through 90+ services including Telegram, Discord, Slack, email, and Pushover. Create multiple status pages mapped to custom domains, enable two-factor authentication, and configure proxy support for complex network topologies.

Deployment

Deploy via Docker with a single command or install directly on major Linux distributions, Windows 10+, and Windows Server 2012 R2+. The application requires Node.js 18/20.4+ and runs on port 3001 by default. PM2 process management is recommended for non-Docker deployments to ensure background operation and automatic restarts.

Highlights

Monitor HTTP(s), TCP, ping, DNS, Docker containers, and 10+ endpoint types
90+ notification integrations including Telegram, Discord, Slack, and email
Multiple customizable status pages with domain mapping support
Real-time WebSocket-powered UI with 20-second check intervals

Pros

  • Comprehensive protocol support covering most monitoring scenarios
  • Extensive notification service integrations out of the box
  • Simple Docker deployment with persistent volume storage
  • Active development with 75,000+ GitHub stars and strong community

Considerations

  • Does not support FreeBSD, OpenBSD, NetBSD, or platform-as-a-service hosts like Replit
  • Network file systems (NFS) are explicitly unsupported for data storage
  • Minimum 20-second check intervals may not suit high-frequency monitoring needs
  • Non-Docker installation requires manual dependency management and PM2 configuration

Managed products teams compare with

When teams consider Uptime Kuma, these hosted platforms usually appear on the same shortlist.

Better Stack (Uptime) logo

Better Stack (Uptime)

Uptime monitoring and incident management service that alerts teams when websites or services go down

incident.io logo

incident.io

All-in-one AI platform for incident management, on-call, and status pages

Instatus logo

Instatus

Status page and incident monitoring platform for service uptime

Looking for a hosted option? These are the services engineering teams benchmark against before choosing open source.

Fit guide

Great for

  • Teams seeking full control over monitoring infrastructure and data
  • Organizations requiring custom status pages on branded domains
  • Environments with diverse monitoring needs across protocols and services
  • Users wanting extensive notification flexibility without per-service costs

Not ideal when

  • Deployments requiring sub-20-second monitoring intervals
  • Infrastructure relying on network file systems for storage
  • BSD-based systems or platform-as-a-service environments
  • Teams preferring managed SaaS solutions without self-hosting overhead

How teams use it

Multi-Service Infrastructure Monitoring

Track web applications, APIs, databases, and Docker containers from a unified dashboard with real-time alerts to Slack when services go down.

Client-Facing Status Pages

Publish branded status pages on custom domains showing service availability, incident history, and uptime metrics without third-party branding.

Certificate Expiration Tracking

Monitor SSL/TLS certificate validity across multiple domains and receive proactive notifications before certificates expire.

Game Server Availability

Track Steam game server uptime and latency with ping charts, ensuring players receive timely updates about server status.

Tech snapshot

JavaScript54%
Vue43%
TypeScript1%
SCSS1%
Dockerfile1%
Go1%

Tags

monitoruptime-monitoringself-hosteduptimewebappresponsivesingle-page-appsocket-iomonitoringwebsocketdockerselfhosted

Frequently asked questions

What protocols and services can Uptime Kuma monitor?

Uptime Kuma monitors HTTP(s), TCP ports, ping, DNS records, push endpoints, Docker containers, Steam game servers, and supports keyword/JSON query validation for HTTP(s) endpoints.

Can I run Uptime Kuma without Docker?

Yes. Install on major Linux distributions or Windows 10+ with Node.js 18/20.4+, npm 9, Git, and PM2. Clone the repository, run npm setup, and start with PM2 for background operation.

How many notification services are supported?

Over 90 notification services are supported including Telegram, Discord, Gotify, Slack, Pushover, and email via SMTP, covering most popular communication platforms.

What is the minimum monitoring interval?

The minimum check interval is 20 seconds. This interval applies to all monitoring types and cannot be reduced below this threshold.

Can I use network file systems like NFS for storage?

No. Network file systems are explicitly unsupported. You must map Docker volumes to local directories or use local file systems for data persistence.

Project at a glance

Active
Stars
81,702
Watchers
81,702
Forks
7,290
LicenseMIT
Repo age4 years old
Last commityesterday
Self-hostingSupported
Primary languageJavaScript

Last synced 12 hours ago