Guide: Install Uptime Kuma – Beautiful Open-Source Self-Hosted Monitoring Dashboard

[Cloud-Moon]

Guide: Install Uptime Kuma – Beautiful Open-Source Self-Hosted Monitoring Dashboard

If you are running multiple VPN servers, websites, or Docker containers, you need a reliable way to monitor their uptime. Uptime Kuma is a gorgeous, self-hosted alternative to UptimeRobot. It pings your services, alerts you via Discord/Telegram/Email when something goes down, and provides a clean status page for your users.

---

Prerequisites

• A Linux server with Docker and Docker Compose v2 installed
• Port 3001/tcp open in your firewall

---

Step 1: Create a Dedicated Directory
Keep your server organized by creating a specific folder for Uptime Kuma's data storage:

sudo mkdir -p /opt/uptime-kuma
cd /opt/uptime-kuma

---

Step 2: Create the Docker Compose Configuration
Create a new deployment file using your terminal text editor:

sudo nano compose.yaml

Paste the following official, lightweight Docker container block:

version: '3.8'

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

Save and exit (Ctrl+O, Enter, Ctrl+X).

---

Step 3: Boot Up the Monitoring Stack
Pull the latest stable image layer and launch the container securely in the background:

sudo docker compose up -d

---

Step 4: Access and Configure Your Monitors

1. Open your web browser and navigate to: http://your_server_ip:3001
2. Create your initial master admin username and secure password.
3. Click "Add New Monitor". You can track raw website HTTP codes, WireGuard ports, Ping responses, or game server statuses.
4. Go to "Status Pages" at the top right to build a public dashboard showing off your 100% server availability!

---

What services are you monitoring with Kuma? Post a screenshot of your custom public status pages below!