Setup Uptime Kuma

Introduction

โน๊ตนี้คือ วิธีการ setup uptime kuma แบบไม่ใช้ docker

• สำหรับข้อมูลฉบับเต็มสามารถดูได้ที่ louislam/uptime-kuma

อัปเดต 2026-08-09 ตอนที่เขียนโน๊ตนี้ครั้งแรกยังเป็น 1.23.x อยู่ ตอนนี้ 2.x ออกมาแล้วนะ เลยกลับมาแก้ส่วนของการอัปเดตให้ตรงกับของจริง

1. Basic setup

sudo apt update && sudo apt upgrade -y
sudo timedatectl set-timezone Asia/Bangkok

sudo apt install curl git -y

2. Install nodejs (v.22) and pm2

Uptime Kuma 2.x บังคับ nodejs ตั้งแต่ 20.4.0 ขึ้นไป (ดูได้จาก engines ใน package.json ของ repo) ลง v.22 ไปเลยก็ได้ครับ

curl -sL https://deb.nodesource.com/setup_22.x -o /tmp/nodesource_setup.sh

sudo bash /tmp/nodesource_setup.sh

sudo apt install nodejs

# Verify
node -v

# Install pm2
sudo npm install -g pm2

# Verify
pm2 --version

3. Install Uptime Kuma

git clone https://github.com/louislam/uptime-kuma.git

cd uptime-kuma

npm run setup

pm2 install pm2-logrotate

pm2 start server/server.js --name uptime-kuma

pm2 save && pm2 startup

npm run setup จะ checkout ไปที่ tag ล่าสุดให้เองครับ ไม่ต้องระบุ version เอง ตอนนี้ (2026-08-09) คือ 2.5.0

http://ip:3001

4. Update Uptime Kuma

cd uptime-kuma

git fetch --all
git checkout 2.5.0 --force

npm ci --omit dev
npm run download-dist

pm2 restart uptime-kuma

เลข version ตรง git checkout เปลี่ยนตามอันล่าสุดได้เลย ดูได้ที่ Releases

ถ้าอัปจาก 1.x มา 2.x อันนี้เป็น major version มี breaking changes อยู่ ทาง repo แนะนำให้สำรองข้อมูลก่อน แล้วอ่าน Migration From v1 To v2 ให้จบก่อนนะ

Ref

• louislam/uptime-kuma
• Releases