# Uptime Kuma

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

- Replaces: [UptimeRobot](https://openlogs.fyi/alternatives/uptimerobot)
- Summary: Hosted uptime monitoring services, such as UptimeRobot.
- Stack: Node.js (runtime)
- Deployment: docker_compose, docker, manual
- License: MIT (osi) [source](https://github.com/louislam/uptime-kuma/blob/2adb5bc32cb53a93722a7c348364a8290acd74d4/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](https://github.com/louislam/uptime-kuma/blob/2adb5bc32cb53a93722a7c348364a8290acd74d4/README.md), read 2026-10-21)
- Difficulty: easy. One container. Its data is a ./data folder next to the compose file, and it needs no outside services.
- Requirements: not stated
- Repository: [louislam/uptime-kuma](https://github.com/louislam/uptime-kuma)

## Install

1. Docker with the Compose plugin ([source](https://github.com/louislam/uptime-kuma/blob/2adb5bc32cb53a93722a7c348364a8290acd74d4/README.md))

   ```text
   A host with Docker and the Docker Compose plugin.
   ```

2. Save the compose file as compose.yaml ([source](https://github.com/louislam/uptime-kuma/blob/2adb5bc32cb53a93722a7c348364a8290acd74d4/compose.yaml))

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

3. Start it ([source](https://github.com/louislam/uptime-kuma/blob/2adb5bc32cb53a93722a7c348364a8290acd74d4/README.md))

   ```bash
   docker compose up -d
   ```

4. Check that it answers ([source](https://github.com/louislam/uptime-kuma/blob/2adb5bc32cb53a93722a7c348364a8290acd74d4/README.md))

   ```text
   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. ([source](https://github.com/louislam/uptime-kuma/blob/2adb5bc32cb53a93722a7c348364a8290acd74d4/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. ([source](https://github.com/louislam/uptime-kuma/blob/2adb5bc32cb53a93722a7c348364a8290acd74d4/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. ([source](https://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. ([source](https://github.com/louislam/uptime-kuma/blob/2adb5bc32cb53a93722a7c348364a8290acd74d4/README.md), checked 2026-10-21)

### Signals

Computed from a GitHub snapshot taken 2026-10-21.

- Open issues and pull requests: 848
- Stars: 92690, forks: 8581
- Last push: 2026-10-21 (0 days ago)
- Latest release: 2.5.6 on 2026-10-09 (12 days ago)

## Sources

- [Repository: https://github.com/louislam/uptime-kuma](https://github.com/louislam/uptime-kuma)
- [License: https://github.com/louislam/uptime-kuma/blob/2adb5bc32cb53a93722a7c348364a8290acd74d4/LICENSE](https://github.com/louislam/uptime-kuma/blob/2adb5bc32cb53a93722a7c348364a8290acd74d4/LICENSE)
- [Business model: https://github.com/louislam/uptime-kuma/blob/2adb5bc32cb53a93722a7c348364a8290acd74d4/README.md](https://github.com/louislam/uptime-kuma/blob/2adb5bc32cb53a93722a7c348364a8290acd74d4/README.md)
- [Compose file: https://github.com/louislam/uptime-kuma/blob/2adb5bc32cb53a93722a7c348364a8290acd74d4/compose.yaml](https://github.com/louislam/uptime-kuma/blob/2adb5bc32cb53a93722a7c348364a8290acd74d4/compose.yaml)
- [Note: https://github.com/louislam/uptime-kuma/wiki/%F0%9F%86%99-How-to-Update](https://github.com/louislam/uptime-kuma/wiki/%F0%9F%86%99-How-to-Update)

---
Canonical: https://openlogs.fyi/tools/uptime-kuma  
Last updated: 2026-10-22