uptime-kuma logo

uptime-kuma

A fancy self-hosted monitoring tool

louislamdockerdockeruptime-kuma
Website GitHub

What is it?

What it is

Uptime Kuma is an easy-to-use self-hosted monitoring tool. Try it! Demo Server (Location: Frankfurt - Germany): <https://demo.kuma.pet/start-demo>

Why it exists

A fancy self-hosted monitoring tool

Who should use it

Teams building with JavaScript who want an open-source, self-hosted option.

Who should avoid it

Teams that need a fully managed SaaS with enterprise SLAs out of the box.

How it works

A quick walkthrough in plain English

How uptime-kuma works

Step 1 of 3

You interact with it

Open uptime-kuma, send a request, or connect it to your stack.

Features

Docker
Monitor
Monitoring
Responsive
Self Hosted
Selfhosted

Advantages

  • Open source (MIT)
  • Active JavaScript ecosystem
  • Self-hosted deployment options

Disadvantages

  • Requires operational ownership for self-hosted setups
  • Community support varies by project maturity

Installation

docker

docker run ... -p 127.0.0.1:3001:3001 ...

native

git clone https://github.com/louislam/uptime-kuma.git
cd uptime-kuma
npm run setup

# Option 1. Try it
node server/server.js

# (Recommended) Option 2. Run in the background using PM2
# Install PM2 if you don't have it:
npm install pm2 -g && pm2 install pm2-logrotate

# Start Server
pm2 start server/server.js --name uptime-kuma

compose

mkdir uptime-kuma
cd uptime-kuma
curl -o compose.yaml https://raw.githubusercontent.com/louislam/uptime-kuma/master/compose.yaml
docker compose up -d

FAQ

What is uptime-kuma?

uptime-kuma is an open-source project licensed under MIT.

What language is uptime-kuma built with?

Primary language: JavaScript.

Is it free to use?

Yes. Licensed under MIT. Check the license for commercial use.

Can I run it with Docker?

Yes. Docker install instructions are in the Installation section.

Loading documentation…
View on GitHub

Featured in Videos

YouTube tutorials and walkthroughs for uptime-kuma

Alternatives

Similar projects ranked by category, topics, and text overlap.

Compare
uptime-kuma | MushyBook