Uptime Kuma

Checks your websites, ports and services on a schedule and sends an alert when one goes down.

Replaces

Hosted uptime monitoring services, such as UptimeRobot.

All open-source alternatives to UptimeRobot

Difficulty

Difficulty: Easy

One container. Its data is a ./data folder next to the compose file, and it needs no outside services.

Stack

Node.js (runtime)

Deployment

docker_compose, docker, manual

Requirements

Not stated.

License

MIT (OSI-approved open source)

Read from github.com/louislam/uptime-kuma/blob/2adb5bc/LICENSE

Business model

Unknown

The README asks for support through GitHub Sponsors and Open Collective. We found no paid plan in the README, so the business model stays unknown.

Source: github.com/louislam/uptime-kuma/blob/2adb5bc/README.md, read on 2026-10-21.

Repository

louislam/uptime-kuma

GitHub stats

Stars: 92,690
Forks: 8,581
Open issues and pull requests: 848
Last push: 2026-10-21
Latest release: 2.5.6
Released: 2026-10-09

From the GitHub API on 2026-10-21. These numbers are a snapshot, not live. GitHub detected the license as MIT.

Compose file

Config check passed docker compose config exited 0 on this exact file on 2026-10-21.

compose.yaml Version 1

services:
  uptime-kuma:
    image: louislam/uptime-kuma:2
    restart: unless-stopped
    volumes:
      - ./data:/app/data
    ports:
      # <Host Port>:<Container Port>
      - "3001:3001"

From the app's own repository: github.com/louislam/uptime-kuma/blob/2adb5bc/compose.yaml.

docker compose config (Docker Compose v5.1.0) exited 0 on this exact file. That check covers YAML and the compose schema. It does not start the containers.

Install

Docker with the Compose plugin (github.com/louislam/uptime-kuma/blob/2adb5bc/README.md)
A host with Docker and the Docker Compose plugin.
Save the compose file as compose.yaml (github.com/louislam/uptime-kuma/blob/2adb5bc/compose.yaml)
Use the compose file shown above.
Start it (github.com/louislam/uptime-kuma/blob/2adb5bc/README.md)
```
docker compose up -d
```
Check that it answers (github.com/louislam/uptime-kuma/blob/2adb5bc/README.md)
Open http://localhost:3001 or http://your-ip:3001. The README says it listens on all network interfaces.

Compose file check: config_ok on 2026-10-21.

Gotchas and maintenance

Gotchas

NFS is not supported for the data folder. The README says file systems like NFS are not supported. The data folder must be a local directory or a Docker volume. (github.com/louislam/uptime-kuma/blob/2adb5bc/README.md, checked 2026-10-21)
Port 3001 is open on all interfaces. The README says the app listens on all network interfaces. For the docker run form it shows -p 127.0.0.1:3001:3001 to listen on localhost only. The compose file publishes 3001:3001. (github.com/louislam/uptime-kuma/blob/2adb5bc/README.md, checked 2026-10-21)

Upgrades

Upgrade steps are in the project wiki. The README points to the wiki page "How to Update" for upgrades. (github.com/louislam/uptime-kuma/wiki/%F0%9F%86%99-How-to-Update, checked 2026-10-21)

Requirements

Node.js for a non-Docker install. The README lists Node.js 20.4 or newer as a requirement for the non-Docker install. The Docker image does not need it on the host. (github.com/louislam/uptime-kuma/blob/2adb5bc/README.md, checked 2026-10-21)

Signals

Open issues and pull requests: 848
Last push: 2026-10-21 (0 days before this page was built)
Latest release: 2.5.6 on 2026-10-09 (12 days before this page was built)