This page provides a collection of official resources, documentation, community links, and third-party tools for Uptime Kuma.
Last Updated: February 16, 2026
Latest Version: v2.1.1 (February 13, 2026)
| Resource |
URL |
Description |
| GitHub Repository |
https://github.com/louislam/uptime-kuma |
Source code, issues, releases |
| Docker Hub |
https://hub.docker.com/r/louislam/uptime-kuma |
Official Docker images |
| GitHub Container Registry |
https://ghcr.io/louislam/uptime-kuma |
Mirror Docker images |
| Live Demo |
https://demo.kuma.pet/start-demo |
Try Uptime Kuma online |
| Release Notes |
https://github.com/louislam/uptime-kuma/releases |
Version history and changelogs |
| Resource |
URL |
Description |
| Wiki |
https://github.com/louislam/uptime-kuma/wiki |
Community documentation |
| Security Policy |
https://github.com/louislam/uptime-kuma/security/policy |
Vulnerability reporting |
| Contributing Guide |
https://github.com/louislam/uptime-kuma/blob/master/CONTRIBUTING.md |
How to contribute |
| API Documentation |
https://github.com/louislam/uptime-kuma/wiki/API |
REST API reference |
| Registry |
Image |
Tags |
Architecture |
| Docker Hub |
louislam/uptime-kuma |
:2, :2.1.1, :latest |
amd64, arm64, arm/v7 |
| Docker Hub |
louislam/uptime-kuma |
:2-slim, :2-slim-rootless |
amd64, arm64 |
| GHCR |
ghcr.io/louislam/uptime-kuma |
:2, :2.1.1, :latest |
amd64, arm64, arm/v7 |
¶ Pull Commands
# Docker Hub (recommended)
docker pull louislam/uptime-kuma:2
# GitHub Container Registry
docker pull ghcr.io/louislam/uptime-kuma:2
# Slim variant (smaller footprint)
docker pull louislam/uptime-kuma:2-slim
# Rootless variant (enhanced security)
docker pull louislam/uptime-kuma:2-slim-rootless
Docker:
docker run -d --restart=always \
-p 3001:3001 \
-v uptime-kuma:/app/data \
--name uptime-kuma \
louislam/uptime-kuma:2
Docker Compose:
curl -o compose.yaml https://raw.githubusercontent.com/louislam/uptime-kuma/master/compose.yaml
docker compose up -d
Git Clone:
git clone https://github.com/louislam/uptime-kuma.git
cd uptime-kuma
npm ci --production
npx pm2 start server.js --name uptime-kuma
| Platform |
Command |
| Homebrew (macOS) |
brew install uptime-kuma |
| Snap (Linux) |
snap install uptime-kuma |
| Cloudron |
Available in Cloudron app store |
| YunoHost |
Available in YunoHost app catalog |
| TrueNAS |
Available in TrueCharts catalog |
| Platform |
URL |
Description |
| GitHub Discussions |
https://github.com/louislam/uptime-kuma/discussions |
Q&A, feature requests |
| Reddit |
https://reddit.com/r/UptimeKuma |
Community discussions |
| Discord |
Check GitHub repo for invite |
Real-time chat |
| Matrix/Element |
#uptime-kuma:matrix.org |
Open chat |
| Platform |
Handle/URL |
| Twitter/X |
Follow @louislam |
| Mastodon |
Check GitHub profile |
| YouTube |
Community tutorials available |
| Project |
Description |
URL |
| Uptime Kuma Push |
Push monitoring integration |
GitHub |
| Kuma Commander |
CLI tool for Uptime Kuma |
GitHub |
| Uptime Kuma API |
Python/Node.js API wrappers |
GitHub |
| Custom Themes |
Community-created status page themes |
GitHub |
| Provider |
Documentation |
Integration Type |
| Telegram |
https://core.telegram.org/bots |
Bot API |
| Discord |
https://discord.com/developers/docs/resources/webhook |
Webhook |
| Slack |
https://api.slack.com/messaging/webhooks |
Incoming Webhook |
| Pushover |
https://pushover.net/api |
API |
| Gotify |
https://gotify.net/docs/api |
API |
| ntfy |
https://docs.ntfy.sh/ |
Topic-based |
| Twilio |
https://www.twilio.com/docs/sms/api |
SMS API |
| PagerDuty |
https://developer.pagerduty.com/docs/ |
Events API |
| Opsgenie |
https://docs.opsgenie.com/docs/api |
API |
| Matrix |
https://spec.matrix.org/ |
Client-Server API |
| Provider |
Guide URL |
| Telegram Bot Setup |
https://github.com/louislam/uptime-kuma/wiki/Notification-Settings:-Telegram |
| Discord Webhook Setup |
https://github.com/louislam/uptime-kuma/wiki/Notification-Settings:-Discord |
| Slack Integration |
https://github.com/louislam/uptime-kuma/wiki/Notification-Settings:-Slack |
| Type |
Documentation |
Use Case |
| HTTP(s) |
https://github.com/louislam/uptime-kuma/wiki |
Website monitoring |
| TCP Port |
https://github.com/louislam/uptime-kuma/wiki |
Service availability |
| Ping |
https://github.com/louislam/uptime-kuma/wiki |
Host availability |
| DNS Record |
https://github.com/louislam/uptime-kuma/wiki |
DNS health |
| Push |
https://github.com/louislam/uptime-kuma/wiki/Heartbeat-Monitor |
Cron job monitoring |
| Docker Container |
https://github.com/louislam/uptime-kuma/wiki |
Container health |
| WebSocket |
https://github.com/louislam/uptime-kuma/wiki |
Real-time services |
| Proxy |
Guide URL |
| Nginx |
https://github.com/louislam/uptime-kuma/wiki/Reverse-Proxy |
| Apache |
https://github.com/louislam/uptime-kuma/wiki/Reverse-Proxy |
| Traefik |
https://github.com/louislam/uptime-kuma/wiki/Reverse-Proxy |
| Caddy |
https://github.com/louislam/uptime-kuma/wiki/Reverse-Proxy |
| HAProxy |
https://github.com/louislam/uptime-kuma/wiki/Reverse-Proxy |
| Resource |
URL |
| Let’s Encrypt |
https://letsencrypt.org/ |
| Certbot |
https://certbot.eff.org/ |
| SSL Labs Test |
https://www.ssllabs.com/ssltest/ |
| Tool |
Description |
Repository |
| kuma-cli |
Command-line interface |
GitHub |
| uptime-kuma-cli |
Alternative CLI tool |
GitHub |
| kumactl |
Management utility |
GitHub |
| Language |
Library |
Repository |
| Python |
py-uptime-kuma |
GitHub |
| Node.js |
uptime-kuma-api |
GitHub |
| Go |
go-uptime-kuma |
GitHub |
| Rust |
uptime-kuma-rs |
GitHub |
| Tool |
Description |
Repository |
| Prometheus Exporter |
Export metrics to Prometheus |
GitHub |
| Grafana Dashboard |
Pre-built Grafana dashboards |
GitHub |
| Home Assistant |
Home Assistant integration |
GitHub |
| Zapier |
Automation workflows |
zapier.com |
| Platform |
Channel/Playlist |
Description |
| YouTube |
Self-hosted community channels |
Setup guides, tips |
| YouTube |
Tech tutorial channels |
Feature walkthroughs |
| Resource |
Type |
URL |
| Official Wiki |
Documentation |
https://github.com/louislam/uptime-kuma/wiki |
| Community Blog Posts |
Tutorials |
Various blogs |
| Dev.to Articles |
Technical articles |
https://dev.to/t/uptimekuma |
| Title |
Author |
Description |
| Self-Hosted Monitoring Guide |
Community |
Guide |
| DevOps Monitoring Patterns |
Various |
Industry best practices |
| Resource |
URL |
| Security Policy |
https://github.com/louislam/uptime-kuma/security/policy |
| Report Vulnerability |
https://github.com/louislam/uptime-kuma/security/advisories |
| CVE Database |
https://cve.mitre.org/ |
| Tool |
Purpose |
| Docker Scout |
Container vulnerability scanning |
| Trivy |
Container security scanner |
| Snyk |
Dependency vulnerability scanning |
| Organization |
URL |
Notes |
| Uptime Kuma Demo |
https://demo.kuma.pet |
Official demo |
| Community Examples |
Check GitHub discussions |
User-submitted |
| Resource |
Description |
URL |
| Official Themes |
Built-in status page themes |
In application |
| Custom CSS |
Community CSS modifications |
GitHub Gists |
| Status Page Templates |
Pre-configured layouts |
GitHub |
| Method |
Details |
| GitHub Issues |
For bugs and feature requests |
| GitHub Discussions |
For questions and community help |
| Documentation |
Check wiki and README first |
| Community Chat |
Discord/Matrix for real-time help |
- Check existing issues first
- Provide detailed reproduction steps
- Include environment information
- Attach relevant logs
- Follow issue template
| Contribution Type |
How to Help |
| Code |
Submit PRs on GitHub |
| Documentation |
Improve wiki and README |
| Translations |
Contribute on Weblate |
| Bug Reports |
File detailed issues |
| Feature Requests |
Use GitHub Discussions |
| Community Help |
Answer questions |
# Clone repository
git clone https://github.com/louislam/uptime-kuma.git
cd uptime-kuma
# Install dependencies
npm ci
# Run in development mode
npm run dev
# Run tests
npm test
Any questions?
Feel free to contact us. Find all contact information on our contact page.