Repolode
Submit
louislam

louislam/uptime-kuma

Self-hosted uptime monitoring tool that tracks HTTP, TCP, DNS, ping, Docker and other services with alerts and status pages.

Open-source alternative to:UptimeRobotPingdom

View on GitHubWebsite
Stars
92,630
Forks
8,570
Open issues
848
Last commit
yesterday

What is it?

Uptime Kuma is a self-hosted monitoring tool with a web dashboard for checking whether your websites and services are online. It can monitor HTTP(s), keyword and JSON query checks, TCP ports, WebSocket endpoints, ping, DNS records, Steam game servers and Docker containers, and it also accepts push-based heartbeats.

When a monitor goes down, Uptime Kuma can send notifications through Telegram, Discord, Slack, Gotify, Pushover, email (SMTP) and many other services. It also supports multiple public status pages, which can be mapped to custom domains, along with ping charts and certificate information.

It is installed with Docker or directly on Linux and Windows with Node.js, and the UI is available in multiple languages.

Key features

  • 01Monitors HTTP(s), keyword, JSON query, TCP, WebSocket, ping, DNS, Steam and Docker targets
  • 02Sends alerts through Telegram, Discord, Slack, email and many other notification services
  • 03Provides multiple status pages, optionally mapped to custom domains
  • 04Shows ping charts and SSL certificate information
  • 05Supports proxies and two-factor authentication

Use cases

  • Watching the uptime of personal or company websites and APIs from your own server
  • Monitoring internal services and Docker containers in a home lab or private network
  • Publishing a public status page for users during outages

Quick start

  1. 1

    Create a folder and enter it

    mkdir uptime-kuma cd uptime-kuma
  2. 2

    Download the Docker Compose file

    curl -o compose.yaml https://raw.githubusercontent.com/louislam/uptime-kuma/master/compose.yaml
  3. 3

    Start Uptime Kuma in the background; then open http://localhost:3001

    docker compose up -d

Things to know

  • Requires Docker or Node.js 20.4+ and Git to run; Docker is the simplest route.
  • File systems such as NFS are not supported for data storage.
  • Non-Docker installs are not supported on FreeBSD, OpenBSD, NetBSD, Replit or Heroku.

Topics

#uptime-monitoring#self-hosted#monitoring#status-page#docker#websocket#notifications#monitor#responsive#selfhosted

FAQ

What is uptime-kuma?
Self-hosted uptime monitoring tool that tracks HTTP, TCP, DNS, ping, Docker and other services with alerts and status pages. Uptime Kuma is a self-hosted monitoring tool with a web dashboard for checking whether your websites and services are online. It can monitor HTTP(s), keyword and JSON query checks, TCP ports, WebSocket endpoints, ping, DNS records, Steam game servers and Docker containers, and it also accepts push-based heartbeats.
Is uptime-kuma free to use? What license does it have?
uptime-kuma is open source under the MIT license. Check the license terms before using it in commercial products.
Is uptime-kuma still maintained?
Actively maintained. The last commit to uptime-kuma was on Oct 19, 2026.
What can I use uptime-kuma for?
Watching the uptime of personal or company websites and APIs from your own server Monitoring internal services and Docker containers in a home lab or private network Publishing a public status page for users during outages
How do I install uptime-kuma?
Create a folder and enter it: mkdir uptime-kuma cd uptime-kuma Download the Docker Compose file: curl -o compose.yaml https://raw.githubusercontent.com/louislam/uptime-kuma/master/compose.yaml Start Uptime Kuma in the background; then open http://localhost:3001: docker compose up -d
Where can I get uptime-kuma?
The source code and installation instructions are on GitHub: https://github.com/louislam/uptime-kuma

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects