Skip to main content

Uptime Kuma

Uptime Kuma (website) is a tool specifically designed for monitoring the availability and uptime of services and websites. It checks if services are running and responds as expected by sending HTTP requests at regular intervals. In contrast to the Node Exporter/Prometheus/Grafana stack, Uptime Kuma places a greater emphasis on ensuring the accessibility and responsiveness of your services rather than collecting in-depth system metrics.

This is a easy and ideal solution to ensure constant monitoring of your node to prevent any downtime. To get started, you can self-host this tool in a Docker container by executing the following command:

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

Once the container has started and appears healthy, you can access Uptime Kuma through HTTP


Now, you can click on Add new monitor:

  • on Monitor type select TCP Port
  • in the Hostname field, add your node's IP address
  • in the Port field, add the TCP port (on this guide, the port is 12345)

In Notifications, you can select your favorite notification type. Let's cover an example using Telegram.

Go to BotFather, create your alert bot and take note of the generated token

Go to ChatIDrobot and get your chat_id

Write a "test message on your bot"

Click on the link to check the api

Finally click on Test to check if the Telegram alert system works

Then save.

Contratulations, your bot is now active!