Back to articles
AI & Cloud

Guide to Deploy Uptime Kuma for Website Status Monitoring and Automatic Telegram Notifications

A detailed guide to deploying Uptime Kuma on a VPS to monitor website status and send automatic alerts via Telegram.

DPTCloud Engineering4 min read
Guide to Deploy Uptime Kuma for Website Status Monitoring and Automatic Telegram Notifications

Image credit: jamesmarkosborne · Pixabay Content License

Introduction to Uptime Kuma

Uptime Kuma is an open-source website status monitoring tool that allows you to track websites, APIs, network services, and more. With a user-friendly interface, Uptime Kuma provides automatic notifications via Telegram, Email, Slack, and other platforms when issues are detected.

This guide walks you through deploying Uptime Kuma on a VPS to monitor website status and receive instant alerts via Telegram. It is optimized for users in Vietnam using VPS services locally or internationally.

System Requirements and Preparation

To deploy Uptime Kuma, you will need:

Deploy Uptime Kuma on VPS

Use Docker to deploy Uptime Kuma quickly and easily.

1. Install Docker

Run the following commands on your VPS:

# Update the system
sudo apt update && sudo apt upgrade -y

# Install required packages
sudo apt install -y apt-transport-https ca-certificates curl gnupg lsb-release

# Add Docker's GPG key
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg

# Add Docker repository
echo "deb [arch=amd64 signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

# Update and install Docker
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin

# Enable and start Docker service
sudo systemctl enable docker
sudo systemctl start docker

2. Create Telegram Bot and Get Token

Access BotFather on Telegram, create a new bot, and retrieve the API token.

Use the following command to get your Telegram user ID (you must send a message to the bot first):

curl -s "https://api.telegram.org/bot<YOUR_BOT_TOKEN>/getUpdates" | jq '.result[0].message.chat.id'

Replace `` with your actual token.

3. Install Uptime Kuma Using Docker

Create a directory for data storage:

mkdir -p ~/uptime-kuma/data

Use this Docker Compose configuration:

# ~/uptime-kuma/docker-compose.yml
version: '3.8'

services:
  uptime-kuma:
    image: louislam/uptime-kuma:1
    container_name: uptime-kuma
    volumes:
      - ./data:/app/data
    ports:
      - "3001:3001"
    restart: unless-stopped

Run the following commands:

cd ~/uptime-kuma
docker-compose up -d

Configure Telegram Notifications

Access the web interface at http://:3001. Log in (default credentials: admin/admin).

Go to Settings → Notifications → Add Notification.

  • Select Telegram as the notification method
  • Enter the Bot Token from BotFather
  • Enter the Chat ID (user or group ID)
  • Save the configuration

Add Websites to Monitor

In the Uptime Kuma interface, click Add New Monitor.

  • Select the monitoring type: HTTP, Ping, TCP, etc.
  • Enter the URL of the website to monitor
  • Set the check interval (e.g., 1 minute)
  • Select Telegram as the notification channel
  • Save the monitor

Verify and Test

To verify the setup, you can:

  • Temporarily disable the website (stop the server or disconnect the network)
  • Wait one minute and check for a Telegram notification
  • Visit http://:3001 to view the status

Troubleshooting

  • Cannot access the interface: Ensure port 3001 is open (use sudo ufw allow 3001 if using UFW)
  • No Telegram notifications: Verify the token and chat ID; ensure the bot can send messages
  • Docker not running: Run docker ps to check container status

References

DPTCloud Tier III Infrastructure

High-RAM Cloud VPS Plans Optimized for AI, Databases & Cache

Enterprise RAID 10 NVMe SSDs, CMC & FPT District 9 uplinks with Anycast Anti-DDoS and 99.99% SLA.

View 22 VPS Plans
ECO · vn-02Recommended

VPS-4E

297.000 ₫ / mo

10% VAT included

  • CPU: 4 vCPU
  • RAM: 8 GB
  • SSD: 50 GB NVMe
ECO · vn-02

VPS-5E

614.900 ₫ / mo

10% VAT included

  • CPU: 8 vCPU
  • RAM: 16 GB
  • SSD: 100 GB NVMe
ADVANCED · vn-03Recommended

VPS-4T

548.900 ₫ / mo

10% VAT included

  • CPU: 4 vCPU
  • RAM: 8 GB
  • SSD: 50 GB NVMe

Related Articles

View all
ZaloZalo SupportDiscord0384 753 478