mirror of https://github.com/louislam/uptime-kuma.git synced 2024-11-27 16:54:04 +00:00

A fancy self-hosted monitoring tool

docker hacktoberfest monitor monitoring responsive self-hosted selfhosted single-page-app socket-io uptime uptime-monitoring webapp websocket

Find a file

Louis Lam 204624bfe9 Merge pull request #133 from NiNiyas/lunasea-support Adds support for LunaSea notifications		2021-07-31 14:02:29 +08:00
.do	the docker image to DO is not working at all, try git method	2021-07-11 22:12:14 +08:00
.github	Create codeql-analysis.yml	2021-07-27 20:25:59 +08:00
data	init	2021-06-25 21:55:49 +08:00
db	add back maxretries field	2021-07-30 00:13:48 +08:00
extra	Fix Docker build	2021-07-18 13:51:44 +02:00
public	Apple touch icon 192px with preserved transparency	2021-07-23 12:41:02 +08:00
server	run eslint for lunasea change	2021-07-31 13:35:18 +08:00
src	add LinaSea option in select box	2021-07-31 13:37:42 +08:00
.dockerignore	fix icon for "Resume"	2021-07-30 01:02:41 +08:00
.editorconfig	update .editorconfig	2021-07-13 10:31:31 +08:00
.eslintrc.js	turn off object-curly-newline, it makes const { a, b, c, d } = require(...) ugly	2021-07-30 22:11:14 +08:00
.gitignore	add retries for pinging function	2021-07-19 18:23:06 +02:00
.stylelintrc	Add ESLint and StyleLint	2021-07-27 19:33:44 +02:00
app.json	test heroku deployment	2021-07-29 00:36:35 +08:00
docker-compose.yml	add some comments and remove traefik-network from docker-composer.yml	2021-07-13 10:28:07 +08:00
dockerfile	remove "pip3 cache purge" that causes error	2021-07-31 12:21:39 +08:00
index.html	Add description	2021-07-17 22:53:32 +02:00
LICENSE	Create LICENSE	2021-07-11 16:02:45 +08:00
package-lock.json	Fix: use new version of babel-eslint-parser	2021-07-30 12:35:33 +08:00
package.json	Fix: use new version of babel-eslint-parser	2021-07-30 12:35:33 +08:00
README.md	update readme	2021-07-30 15:04:52 +08:00
tsconfig.json	add util.ts for sharing common functions between frontend and backend	2021-07-30 11:23:04 +08:00
vite.config.js	drop ie support when build the frontend	2021-07-13 18:34:09 +08:00

README.md

Uptime Kuma

It is a self-hosted monitoring tool like "Uptime Robot".

Features

Monitoring uptime for HTTP(s) / TCP / Ping.
Fancy, Reactive, Fast UI/UX.
Notifications via Webhook, Telegram, Discord, Gotify, Slack, Pushover, Email (SMTP) and more by Apprise.
20 seconds interval.

How to Use

Docker

# Create a volume
docker volume create uptime-kuma

# Start the container
docker run -d --restart=always -p 3001:3001 -v uptime-kuma:/app/data --name uptime-kuma louislam/uptime-kuma:1

Browse to http://localhost:3001 after started.

Change Port and Volume

docker run -d --restart=always -p <YOUR_PORT>:3001 -v <YOUR_DIR OR VOLUME>:/app/data --name uptime-kuma louislam/uptime-kuma:1

Without Docker

Required Tools: Node.js >= 14, git and pm2.

git clone https://github.com/louislam/uptime-kuma.git
cd uptime-kuma
npm run setup

# Option 1. Try it
npm run start-server

# (Recommended) 
# Option 2. Run in background using PM2
# Install PM2 if you don't have: npm install pm2 -g
pm2 start npm --name uptime-kuma -- run start-server

# Listen to different port or hostname
pm2 start npm --name uptime-kuma -- run start-server -- --port=80 --hostname=0.0.0.0

Browse to http://localhost:3001 after started.

One-click Deploy

How to Update

Docker

Re-pull the latest docker image and create another container with the same volume.

PS: For every new release, it takes some time to build the docker image, please be patient if it is not available yet.

Without Docker

git fetch --all
git checkout 1.0.7 --force
npm install
npm run build
pm2 restart uptime-kuma

What's Next?

I will mark requests/issues to the next milestone. https://github.com/louislam/uptime-kuma/milestones

More Screenshots

Settings Page:

Telegram Notification Sample:

Motivation

I was looking for a self-hosted monitoring tool like "Uptime Robot", but it is hard to find a suitable one. One of the close one is statping. Unfortunately, it is not stable and unmaintained.
Want to build a fancy UI.
Learn Vue 3 and vite.js.
Show the power of Bootstrap 5.
Try to use WebSocket with SPA instead of REST API.
Deploy my first Docker image to Docker Hub.

If you love this project, please consider giving me a ⭐.

Contribute

If you want to report a bug or request a new feature. Free feel to open a new issue.

If you want to modify Uptime Kuma, this guideline maybe useful for you: https://github.com/louislam/uptime-kuma/wiki/%5BDev%5D-Setup-Development-Environment

English proofreading is needed too, because my grammar is not that great sadly. Feel free to correct my grammar in this Readme, source code or wiki.