+109
日增长
+1,055
周增长
94,455
stars
8,849
forks
319
watchers
2,984
prs
5,088
issues
142
releases
README
Uptime Kuma
Uptime Kuma is an easy-to-use self-hosted monitoring tool.
🥔 Live Demo
Try it!
Demo Server (Location: Frankfurt - Germany):
It is a temporary live demo, all data will be deleted after 10 minutes. Sponsored by Uptime Kuma Sponsors.
[!WARNING]
Be careful - the top result in Google, uptimekuma.co, is not our official website, we don't control the website. I recommend following the installation guide in this GitHub repo.
⭐ Features
- Monitoring uptime for HTTP(s) / TCP / HTTP(s) Keyword / HTTP(s) Json Query / Websocket / Ping / DNS Record / Push / Steam Game Server / Docker Containers
- Fancy, Reactive, Fast UI/UX
- Notifications via Telegram, Discord, Gotify, Slack, Pushover, Email (SMTP), and 90+ notification services, click here for the full list
- 20-second intervals
- Multi Languages
- Multiple status pages
- Map status pages to specific domains
- Ping chart
- Certificate info
- Proxy support
- 2FA support
🔧 How to Install
🐳 Docker Compose
bash
mkdir uptime-kuma
cd uptime-kuma
curl -o compose.yaml https://raw.githubusercontent.com/louislam/uptime-kuma/master/compose.yaml
docker compose up -d
Uptime Kuma is now running on all network interfaces (e.g. http://localhost:3001 or http://your-ip:3001).
[!WARNING]
File Systems like NFS (Network File System) are NOT supported. Please map to a local directory or volume.
🐳 Docker Command
bash
docker run -d --restart=always -p 3001:3001 -v uptime-kuma:/app/data --name uptime-kuma louislam/uptime-kuma:2
Uptime Kuma is now running on all network interfaces (e.g. http://localhost:3001 or http://your-ip:3001).
If you want to limit exposure to localhost only:
bash
docker run ... -p 127.0.0.1:3001:3001 ...
💪🏻 Non-Docker
Requirements:
- Platform
- ✅ Major Linux distros such as Debian, Ubuntu, Fedora and ArchLinux etc.
- ✅ Windows 10 (x64), Windows Server 2012 R2 (x64) or higher
- ❌ FreeBSD / OpenBSD / NetBSD
- ❌ Replit / Heroku
- Node.js = 20.4
- Git
- pm2 - For running Uptime Kuma in the background
bash
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
Uptime Kuma is now running on all network interfaces (e.g. http://localhost:3001 or http://your-ip:3001).
More useful PM2 Commands
bash
If you want to see the current console output
pm2 monit
If you want to add it to startup
pm2 startup && pm2 save
Advanced Installation
If you need more options or need to browse via a reverse proxy, please read:
🆙 How to Update
Please read:
🆕 What's Next?
I will assign requests/issues to the next milestone.
❤️ Sponsors
Thank you so much for supporting this project!
Special Sponsors
Atlas Cloud (https://www.atlascloud.ai) is sponsoring this project USD 400 per month fTop issues
#275Lots of 'timeout of 48000ms exceeded' during the day, but the site is still up?107 comments · 2021-08-26#1888Configurable Range heartbeat bar (`7`/`30`/`60`/`90`/`180`/`365` days)96 comments · 2022-07-12#118API functionality84 comments · 2021-07-27#128Allow basic User management without permissions77 comments · 2021-07-30#819Alert for high server `network`/`ram`/`disk`/`cpu` usage "heartbeat" monitoring61 comments · 2021-10-28#1117Exec monitor60 comments · 2022-01-03#84Remote Executors48 comments · 2021-07-19#959Postgres support44 comments · 2021-11-25
Latest release
2.5.11 2.5.11 2026-11-12⬆️ Security Fixes - 8094 chore: Update dependencies - GHSA-437w-j82f-9vjh fix: [Admin Only] RCE via an upstream package's regression (Details will be revealed after 7 days) (Thanks @Tomer-PL)
相关报道 (3)
News & coverage (13)
Hacker NewsA fancy open-source self-hosted monitoring tool▲ 59 · 5 comments · 2021-10-09Hacker NewsUptime Kuma: An easy-to-use self-hosted monitoring tool▲ 2 · 0 comments · 2023-08-17Hacker NewsUptime Kuma: A fancy self-hosted monitoring tool▲ 2 · 0 comments · 2021-08-03Hacker NewsUptime Kuma is an easy-to-use self-hosted monitoring tool▲ 1 · 0 comments · 2024-02-17note⏱ Reviewing UptimeRobot's Annual Fees | Costs by Monitoring Count and Number of Users for Better Stack, Uptime Kuma, and Gatus [November 2026]2026-11-05noteHow to use Uptime Kuma: Set it up with one command, monitor at 20-second intervals, and notify over 90 destinations if it goes down2026-09-11Help Net SecurityUptime Kuma 2.5.0 waits two weeks before trusting a new npm package2026-08-04Help Net SecurityUptime Kuma: Open-source monitoring tool2026-02-19korbenUptime Kuma - A self-hosted monitoring service2021-12-01MakeUseOfThese 6 homelab services are seriously boring and geniunely essential2026-08-15