Uptime Kuma

🌐 What Uptime Kuma Is

Uptime Kuma is an easy‑to‑use, self‑hosted monitoring system that runs on your own hardware and provides a web interface for tracking the status of anything you want to monitor.

You can monitor:

• Websites (HTTP/HTTPS)
• TCP ports
• Ping/ICMP
• DNS queries
• Docker containers
• Custom scripts
• And more

It alerts you when something goes down and logs historical uptime and response times.

⚡ Key Features

• Beautiful, modern dashboard for all your monitors
• Multiple monitor types (HTTP, TCP, Ping, DNS, Push, Steam, Docker, etc.)
• Notifications via email, Telegram, Discord, Slack, Pushover, and many others
• Status pages you can share publicly
• History and response‑time graphs
• Self‑hosted — your data stays on your hardware
• Lightweight — runs well on a Raspberry Pi or small VPS
• Docker‑friendly — official container image with simple deployment instructions

🚀 Docker Installation Steps

1. Update your system
   sudo apt update && sudo apt upgrade -y
2. Install Docker
   

   curl -fsSL https://get.docker.com -o get-docker.sh
   sudo sh get-docker.sh

3. Install Docker Compose
   sudo apt install docker-compose-plugin
4. Add your user to the Docker group
   sudo usermod -aG docker $USER
5. Enable Docker at boot
   sudo systemctl enable docker
6. Reboot
   sudo reboot
7. Test Docker
   docker run hello-world

📁 Setup Uptime Kuma

mkdir -p ~/docker/uptimekuma

🧾 Docker Compose File

In ~/docker/uptimekuma create docker-compose.yml

services:
  uptime-kuma:
    image: louislam/uptime-kuma:latest
    container_name: uptime-kuma
    restart: always
    ports:
      - "3301:3001"   # Expose port 3001 on the host
    volumes:
      - ./uptime-kuma-data:/app/data 

▶️ Start Uptime Kuma

From within /volume2/docker/uptimekuma run:

📜 View Logs

View logs for the Uptime Kuma server:

🌐 Access Web Interface

Open your browser and go to http://<your-device-ip>:3301 and start adding new monitors.

For example, you can setup a monitor to monitor this website:

1. Click on Add New Monitor
2. Give it a name
3. For URL use https://dockerplaybooks.dpdns.org
4. Click Save