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.
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:
- A VPS (Cloud VPS) with at least 1GB RAM and 2GB SSD (consider High-RAM Cloud VPS for Self-Hosted LLMs & API Gateways)
- Linux operating system (Ubuntu 20.04/22.04 or Debian 11)
- SSH access to the VPS
- Telegram Bot API (create a bot at BotFather)
- Public IP address of the VPS (required for sending notifications)
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 `
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://. 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://to view the status:3001
Troubleshooting
- Cannot access the interface: Ensure port 3001 is open (use
sudo ufw allow 3001if using UFW) - No Telegram notifications: Verify the token and chat ID; ensure the bot can send messages
- Docker not running: Run
docker psto check container status
References
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.
VPS-4E
10% VAT included
- CPU: 4 vCPU
- RAM: 8 GB
- SSD: 50 GB NVMe
