Setting Up Uptime Kuma with Docker Compose¶

Introduction to Uptime Kuma¶

Uptime Kuma is a self-hosted monitoring tool similar to "Uptime Robot." It monitors your websites, services, and applications and provides uptime notifications.

Docker Compose Configuration for Uptime Kuma¶

This Docker Compose setup deploys Uptime Kuma in a Docker container, providing a reliable environment for monitoring your services.

Docker Compose File (`docker compose.yml`)¶

version: '3'
services:
  uptime-kuma:
    image: louislam/uptime-kuma:1
    container_name: uptime-kuma
    restart: always
    ports:
      - "3010:3001"
    volumes:
      - uptime-kuma:/app/data
      - /var/run/docker.sock:/var/run/docker.sock

volumes:
  uptime-kuma:

Key Components of the Configuration¶

Service: Uptime Kuma¶

Image: louislam/uptime-kuma:1 is the Docker image for Uptime Kuma.
Ports:
3010:3001 maps port 3010 on the host to port 3001 in the container, where Uptime Kuma's web interface is accessible.
Volumes:
uptime-kuma:/app/data is used for persistent storage of Uptime Kuma data.
/var/run/docker.sock:/var/run/docker.sock allows Uptime Kuma to monitor Docker containers.
Restart Policy: always ensures that Uptime Kuma restarts automatically after a crash or reboot.

Deploying Uptime Kuma¶

Save the Docker Compose configuration in a docker compose.yml file.
Run docker compose up -d to start Uptime Kuma in detached mode.
Access Uptime Kuma's web interface via http://<host-ip>:3010.

Configuring and Using Uptime Kuma¶

After deployment, you can configure Uptime Kuma through its web interface to monitor your websites and services, set up notifications, and track uptime and response times.