Jugaad
Jugaad Tool MITIntermediateDeveloper ToolsFree

uptime-kuma

Self-hosted uptime monitoring for websites, servers and Docker containers, with alerts and custom-domain status pages.

Stars
93k
Forks
8.7k
Last update
5 Nov 2026

Overview

Uptime Kuma checks the availability of websites, network services and Docker containers from your own installation. It supports 20-second monitoring intervals, notifications through many services, and multiple status pages that can use specific domains.

Who it's for

Developers and system administratorsSoftware agencies managing client websitesOnline businesses with customer-facing servicesInstitutional IT teams

Tech stack

JavaScriptNode.jsVue 3vite.jsBootstrap 5WebSocketDockerPM2

Features and benefits

Key features

  • Monitor HTTP(s), TCP, WebSocket, Ping and DNS records.
  • Check HTTP(s) keywords and JSON queries.
  • Monitor Docker containers, Steam game servers and Push monitors.
  • Use 20-second monitoring intervals.
  • Send notifications through Telegram, Discord, Slack, SMTP email and 90+ notification services.
  • Create multiple status pages and map them to specific domains.
  • View ping charts and certificate information.
  • Use proxy support.
  • Protect access with two-factor authentication.
  • Use a reactive interface with multiple languages.

Why it helps in Pakistan

  • Check websites and infrastructure from one self-hosted tool.
  • Receive service alerts through communication channels your team already uses.
  • Share availability information through separate status pages.
  • Check page content as well as basic website availability.
  • Keep control of where your monitoring installation runs.

Pakistan use cases

  • 01

    A Karachi online retailer can monitor its storefront over HTTPS and receive SMTP email alerts.

  • 02

    A Lahore software agency can create separate status pages for client services and map them to specific domains.

  • 03

    An Islamabad development team can monitor Docker containers and send notifications to Slack.

  • 04

    A Pakistani college IT team can check its website for expected keywords and monitor DNS records.

Requirements

Hardware
Check the official docs for CPU, RAM and storage requirements.Use a local directory or volume for Docker data; NFS is not supported.
Operating system
Non-Docker: major Linux distributions, including Debian, Ubuntu, Fedora and ArchLinux.Non-Docker: Windows 10 (x64), Windows Server 2012 R2 (x64) or higher.FreeBSD, OpenBSD, NetBSD, Replit and Heroku are not supported for the documented non-Docker installation.macOS support: Check the official docs.
Skills
Command-line use for installation.Docker or Docker Compose for container installation.For non-Docker installation: Node.js >= 20.4, Git and PM2 for background operation.
Accounts needed
Check the official docs for account requirements for your chosen notification services.

Setup guide

Commands are copied from the project's README and official docs.

  1. 1

    Docker Compose: create a directory

    Run mkdir uptime-kuma, then cd uptime-kuma.
  2. 2

    Download the Compose file

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

    Start and open Uptime Kuma

    Run docker compose up -d, then open http://localhost:3001 or http://your-ip:3001. It listens on all network interfaces. Use local storage rather than NFS.

Works with

  • Telegram

    Receive monitoring notifications.

  • Discord

    Receive monitoring notifications.

  • Slack

    Receive monitoring notifications.

  • Gotify

    Receive monitoring notifications.

  • Pushover

    Receive monitoring notifications.

  • Email (SMTP)

    Send monitoring notifications through SMTP email.

  • Docker

    Monitor Docker containers and run Uptime Kuma as a container.

What it costs

SoftwareFree to self-host under the MIT licence.
HostingHosting costs depend on your server and monitoring workload. Hardware sizing is not stated in the supplied sources; check the official docs and current provider prices.

FAQ

Can I try it before installing?

Yes. The official temporary demo lets you try Uptime Kuma; all demo data is deleted after 10 minutes.

Does it only monitor websites?

No. It also supports TCP, WebSocket, Ping, DNS records, Push, Steam game servers and Docker containers.

Can I use my own domain for a status page?

Yes. Uptime Kuma supports multiple status pages and mapping them to specific domains.

Can I install it without Docker?

Yes. The README documents installation on supported Windows and Linux systems using Node.js >= 20.4 and Git, with PM2 recommended for background operation.

Does it support two-factor authentication?

Yes. Two-factor authentication is listed as a supported feature.

Troubleshooting

The Docker installation uses NFS storage.

Map the application data to a local directory or volume. The README explicitly states that NFS is not supported.

The interface does not open.

Check that the service is running and that you are using port 3001. Check logs and port access; see the official docs.

The non-Docker installation fails.

Verify that Node.js is version 20.4 or higher, Git is installed, and your platform is supported. For a PM2-managed installation, inspect console output with pm2 monit; see the official docs.

You need help configuring a reverse proxy.

Use the official advanced installation guide linked in the README for reverse-proxy options.

Get it set up for you

Don't want to install it yourself? A Jugaad maker can set up uptime-kuma for your business. Payment is held in Safe Deal until it works.

No maker offers a setup gig for this yet. Post a request and makers will quote.

Post a setup request Paid through Safe Deal

Built by louislam and contributors on GitHub. All credit goes to the authors. GitHub stats refresh daily. Jugaad does not host, copy or sell this code.

Is this your project?