Skip to content
Get packs

Uptime Kuma

Self-hosted uptime monitor that checks your sites and services and alerts you when they go down.

GitHub Download 2.5.9
Stars
93.2k
Forks
8.7k
Licence
MIT
Language
JavaScript
Last update
4 days ago
Type
App

What it is

Uptime Kuma is a monitoring tool you run on your own server or computer. It regularly checks websites, servers, and services (over HTTP, TCP, ping, DNS, and other methods) and shows their status in a web dashboard. When something fails, it can send notifications through services such as Telegram, Discord, Slack, or email.

  • Check a website every 20 seconds and get an alert on Discord or Telegram when it goes down
  • Create a public status page and map it to your own domain
  • Monitor a Docker container, a DNS record, or a Steam game server
  • Track certificate information and ping response times over time

Great for

  • People who want to monitor their own websites or services without paying a hosted monitoring service
  • Home lab and self-hosting users who already run Docker
  • Small teams that want a status page for their users
  • Developers who want simple uptime checks for their apps

Not ideal for

  • People who do not want to run and maintain their own server, since the README is built around self-hosting
  • Users on FreeBSD, OpenBSD, NetBSD, Replit, or Heroku, which the README lists as unsupported
  • Anyone needing enterprise-scale monitoring, since the README does not describe that scale
Step-by-step guide: how to use Uptime KumaInstall, first run, examples, tips and FAQs
Beszel vs Uptime KumaDockge vs Uptime KumaUpptime vs Uptime Kuma

How to get it

  1. 1

    Run with Docker

    You'll need: Docker (for the recommended install)

    Docker Compose setup

    mkdir uptime-kuma

    Enter the folder

    cd uptime-kuma

    Download the compose file

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

    Start Uptime Kuma

    docker compose up -d
  2. 2

    Run it

    • Run the Docker Compose commands above
    • Open http://localhost:3001 in your browser
    • Create an admin account on first visit
    • Add a monitor for a website or service you want to check
    • Connect a notification service so you are alerted when a monitor fails
  3. 3

    Get the most out of it

    • Use the status page feature and map it to a custom domain to share service health publicly
    • Set up notifications through one of the many supported services, such as Telegram, Discord, Gotify, or email (SMTP)
    • Enable two-factor authentication (2FA) to protect your dashboard
    • Use the proxy support if your monitored services are reached through a proxy
    • Use the Docker Command option with -p 127.0.0.1:3001:3001 to limit access to localhost

Downloads

Source code (.zip)master branch · straight from GitHubRelease 2.5.91 files incl. dist.tar.gzOfficial website & docsuptime.kuma.pet

Strengths

  • The README describes a clean, responsive web interface with many monitor types in one tool
  • Installation with Docker is a single command, and the README covers both Docker and non-Docker setups
  • Open-source under the MIT license with a large, active community on GitHub

Trade-offs

  • The README warns that NFS file systems are not supported for data storage, so you must use a local volume
  • Non-Docker installs need Node.js 20.4 or newer, Git, and optionally pm2, which takes some setup
  • Advanced setup such as reverse proxies and updates is delegated to the project wiki, so some details live outside the README

How it compares

ProjectStarsTypeLevelUpdatedBest for
uptime-kuma (this)93.2kAppbeginner4 days agoPeople who want to monitor their own websites or services without paying a hosted monitoring service
dockge24.7kAppbeginner14 days agoPeople who run Docker Compose stacks on a home server or small Linux machine
dokku32.2kAppintermediate4 days agoDevelopers who want Heroku-style deployment on a server they control
beszel26.8kAppintermediate5 days agoPeople running a homelab or a few personal servers
memos64.2kAppintermediate4 days agoPeople who want a private, self-hosted journal or quick-notes timeline
gogs47.9kAppintermediate5 days agoSmall teams that want a private Git server on their own hardware

Stats synced from GitHub. The assessment above was drafted with AI from the project's README on 2026-10-29 and may miss recent changes — check the README before relying on a command. MIT licence: free to use, modify and distribute, including commercially, as long as you keep the copyright notice.