selfhosted-apps-docker/uptime-kuma

Uptime Kuma in docker

guide-by-example

Purpose & Overview

Website uptime monitoring and notifications.

• Github

Simple, modern, uptime monitoring, with rich notification system.

Written in javascript.

---

Files and directory structure

/home/
└── ~/
    └── docker/
        └── uptimekuma/
            ├── 🗁 uptimekuma_data/
            └── 🗋 docker-compose.yml

• uptimekuma_data - persistent data, contains sqlite database
• .env - a file containing environment variables for docker compose
• docker-compose.yml - a docker compose file, telling docker how to run the containers

You only need to provide the two files.
The directory is created by docker compose on the first run.

docker-compose

It's a simpler, single container approach.

docker-compose.yml

services:
  uptimekuma:
    image: louislam/uptime-kuma:1
    container_name: uptimekuma
    hostname: uptimekuma
    restart: unless-stopped
    ports:
      - "3001:3001"
    volumes:
      - ./uptimekuma_data:/app/data

networks:
  default:
    name: $DOCKER_MY_NETWORK
    external: true      

.env

# GENERAL
TZ=Europe/Bratislava
DOCKER_MY_NETWORK=caddy_net

Reverse proxy

Caddy v2 is used, details here.

Caddyfile

uptime.{$MY_DOMAIN} {
  reverse_proxy uptimekuma:3001
}

Manual image update:

• docker-compose pull
  
• docker-compose up -d
  
• docker image prune

Backup and restore

Backup

should be just backup of uptimekuma_data directory

not tested yet

Restore