docker run -d --restart=always -p 3001:3001 -v uptime-kuma:/app/data --name uptime-kuma louislam/uptime-kuma:1Uptime Kuma is now running on http://localhost:3001
Warning
NFS (Network File System) are NOT supported. Please map to a local directory or volume.
Browse to http://localhost:3001 after started.
docker run -d --restart=always -p <YOUR_PORT>:3001 -v <YOUR_DIR OR VOLUME>:/app/data --name uptime-kuma louislam/uptime-kuma:1| Tag(s) | Description |
| 1 | Latest stable (👍Recommended Tag) |
| latest, 1, 1.* | Latest stable - debian |
| debian, 1-debian, 1.*-debian | Latest stable - debian |
| ❌alpine, 1-alpine, 1.*-alpine | (❌Deprecated due to DNS issues) Latest stable - alpine |
| nightly* | Development build, unstable |
Example docker-compose template: https://github.com/louislam/uptime-kuma/blob/master/docker/docker-compose.yml
docker compose up -dRequirements:
- Platform
- ✅ Major Linux distros such as Debian, Ubuntu, CentOS, Fedora and ArchLinux etc.
- ✅ Windows 10 (x64), Windows Server 2012 R2 (x64) or higher
- ❌ Replit / Heroku
- Node.js 14 / 16 / 18 / 20.4
- npm 9
- Git
- pm2 - For running Uptime Kuma in the background
# Update your npm
npm install npm@9 -g
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-kumaUptime Kuma is now running on http://localhost:3001
More useful PM2 Commands
# If you want to see the current console output
pm2 monit
# If you want to add it to startup
pm2 save && pm2 startupThis is optional for someone who want to use a reverse proxy.
Unlikely other web apps, Uptime Kuma is based on WebSocket. You need two more headers "Upgrade" and "Connection" in order to reverse proxy WebSocket.
Please read wiki for more info: https://github.com/louislam/uptime-kuma/wiki/Reverse-Proxy
- Learn Uptime Kuma in 5 Minutes by DEVOPS UNLOCKED Install with the docker run command
- Meet Uptime Kuma, a Fancy Open Source Uptime Monitor by Techno Tim Install with docker-compose
- Monitor Status with Uptime Kuma - Let's install Uptime Kuma with Docker by Geeked Install with Portainer
Warning
The following installation methods are provided by the community. They are not tested officially and may be broken in the future release. Use at your own risk.
Note: This Chart relies on a repackaged OCI Container Image, which lets uptime-kuma run as non-root user.
The entire repackage process is automated via GitHub Actions and renovate-bot keeps everything up to date. (feel free to audit it yourself)
The Containerfile used to rebundle uptime-kuma: rootless Containerfile
https://github.com/k3rnelpan1c-dev/uptime-kuma-helm
https://github.com/louislam/uptime-kuma/tree/ansible-unofficial/ansible
https://github.com/hassio-addons/addon-uptime-kuma
Also check out the corresponding custom integration: https://github.com/meichthys/uptime_kuma (WIP).
Unofficial tutorial by Marius Bogdan Lixandru:
https://mariushosting.com/how-to-install-uptime-kuma-on-your-synology-nas/
Run with one click on PikaPods.com. Free for about 3 months with welcome credit.
Do you have an old Android phone? You could install Uptime Kuma on it!
Unofficial tutorial by Stefan: https://haci.io/posts/uptime-kuma-azure-container-instance/
Unofficial tutorial by Leandro: https://www.leandroscardua.com/blog/deploy-uptime-kuma-on-azure/
Unofficial bicep deployment script by Yannick Zwijsen: https://github.com/yzwijsen/deploy-uptime-kuma-azure
Run uptime-kuma with S3 persistent sqlite database: https://github.com/fluential/litestream-uptime-kuma/
Run with one click on Zeabur.
https://docs.zeabur.com/marketplace/uptime-kuma
To try the self-hosted uptime-kuma, 🚀 one-click deploy with Dome with a free trial.