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
Tech stack
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
Docker Compose: create a directory
Runmkdir uptime-kuma, thencd uptime-kuma. - 2
Download the Compose file
Runcurl -o compose.yaml https://raw.githubusercontent.com/louislam/uptime-kuma/master/compose.yaml. - 3
Start and open Uptime Kuma
Rundocker 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.
Monitor Docker containers and run Uptime Kuma as a container.
What it costs
| Software | Free to self-host under the MIT licence. |
|---|---|
| Hosting | Hosting 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.
Official links
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.
Related tools
supabase
by supabase
Build web, mobile, and AI apps with Postgres, authentication, auto-generated APIs, file storage, and realtime updates.
- A Karachi retailer's developers…
- A Lahore software agency could b…
- An Islamabad education startup c…
coolify
by coollabsio
Deploy apps, websites, databases and 360+ services on your own servers with Git automation, HTTPS and backups.
- A Lahore web agency can deploy c…
- A Karachi software team can run…
- An Islamabad startup can deploy…
appwrite
by appwrite
An open-source backend platform with authentication, databases, file storage, functions, hosting, and AI agent tools.
- A Lahore software agency could b…
- A Karachi retailer could develop…
- An Islamabad education startup c…
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?
