우분투 24.04 서버에서 Uptime Kuma를 설치하는 방법

우분투 24.04 서버에서 Uptime Kuma를 설치하는 방법

Uptime Kuma는 간단하게 서버/서비스 상태를 모니터링할 수 있는 강력한 웹 UI 도구입니다.

Docker

1. Docker 설치

sudo apt update
sudo apt install -y ca-certificates curl gnupg

sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] \
  https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" \
  | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin

2. Uptime Kuma 컨테이너 실행

mkdir -p /docker-container/uptime-kuma

cd /docker-container/uptime-kuma

vim docker-compose.yml

services:

  uptime-kuma:
    image: louislam/uptime-kuma:latest
    container_name: uptime-kuma
    hostname: uptime-kuma
    restart: always
    volumes:
      - /usr/share/zoneinfo/Asia/Seoul:/etc/localtime:ro
      - ./uptime-kuma:/app/data
    ports:
      - "3001:3001"

networks:
  default:
      name: uptime-kuma-net

실행

docker compose up -d

브라우저 접속

http://서버IP:3001

3. 모니터링 등록

Uptime Kuma

728x90

네이티브 설치(Node.js 직접 실행)

필요한 패키지 설치

sudo apt update
sudo apt install -y git curl

Node.js LTS 설치

curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt install -y nodejs

Uptime Kuma 다운로드

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

패키지 설치

npm install --production

테스트 실행

npm run start-server

브라우저 접속

http://서버IP:3001

서비스 등록(자동 실행)

sudo vim /etc/systemd/system/uptime-kuma.service

[Unit]
Description=Uptime Kuma
After=network.target

[Service]
Type=simple
User=root
WorkingDirectory=/opt/uptime-kuma
ExecStart=/usr/bin/npm run start-server
Restart=always

[Install]
WantedBy=multi-user.target

서비스 적용 & 시작

sudo systemctl daemon-reload
sudo systemctl enable --now uptime-kuma

상태 확인

sudo systemctl status uptime-kuma

 

참고URL

- GitHub : louislam/uptime-kuma