Uptime Kuma Status Page

Key Features

• Multiple monitor types supporting HTTP/HTTPS, TCP port checks, ping tests, DNS resolution, and Docker container health monitoring
• Beautiful, customizable status pages with real-time updates and incident history for public or private visibility
• Integration with 90+ notification services including Discord, Slack, email, webhooks, and mobile push notifications
• Certificate expiry monitoring with configurable alerts for SSL/TLS certificates
• Two-factor authentication and user management for secure access control
• Proxy support for monitoring services behind firewalls or in restricted networks
• Multi-language interface supporting dozens of languages for international teams
• NGINX reverse proxy providing SSL termination, caching, and improved security isolation

Common Use Cases

• 1SaaS companies providing public status pages to communicate service availability to customers during outages
• 2Development teams monitoring internal APIs, databases, and microservices across staging and production environments
• 3Managed service providers tracking client infrastructure and automatically generating availability reports
• 4E-commerce businesses monitoring critical payment gateways, CDN endpoints, and third-party integrations
• 5Homelab enthusiasts tracking self-hosted applications like Plex, Home Assistant, and NAS systems
• 6IT departments monitoring corporate websites, email servers, and remote office connectivity
• 7Freelance developers offering uptime monitoring as a value-added service to clients

Prerequisites

• Docker and Docker Compose installed with at least 512MB available RAM for both containers
• Ports 80, 443, and 3001 available on the host system for web access and API communication
• Basic understanding of reverse proxy concepts if planning to customize NGINX configuration
• Domain name and SSL certificates if deploying for public status page access
• Network access to services you plan to monitor, including firewall rules for external endpoints
• Email server credentials or notification service API keys for alert delivery

docker-compose.yml

1services: 
2  uptime-kuma: 
3    image: louislam/uptime-kuma:latest
4    volumes: 
5      - uptime-kuma-data:/app/data
6      - /var/run/docker.sock:/var/run/docker.sock:ro
7    ports: 
8      - "3001:3001"
9    networks: 
10      - uptime-network
11    restart: unless-stopped
12
13  nginx: 
14    image: nginx:alpine
15    volumes: 
16      - ./nginx.conf:/etc/nginx/nginx.conf:ro
17    ports: 
18      - "80:80"
19      - "443:443"
20    depends_on: 
21      - uptime-kuma
22    networks: 
23      - uptime-network
24    restart: unless-stopped
25
26volumes: 
27  uptime-kuma-data: 
28
29networks: 
30  uptime-network: 
31    driver: bridge

.env Template

1# Uptime Kuma
2# First-run setup via web UI
3# Create admin account on first visit
4
5# Docker socket for container monitoring

Usage Notes

Individual Services(2 services)

Copy individual services to mix and match with your existing compose files.

uptime-kuma:
  image: louislam/uptime-kuma:latest
  volumes:
    - uptime-kuma-data:/app/data
    - /var/run/docker.sock:/var/run/docker.sock:ro
  ports:
    - "3001:3001"
  networks:
    - uptime-network
  restart: unless-stopped

nginx:
  image: nginx:alpine
  volumes:
    - ./nginx.conf:/etc/nginx/nginx.conf:ro
  ports:
    - "80:80"
    - "443:443"
  depends_on:
    - uptime-kuma
  networks:
    - uptime-network
  restart: unless-stopped

Quick Start

1# 1. Create the compose file
2cat > docker-compose.yml << 'EOF'
3services:
4  uptime-kuma:
5    image: louislam/uptime-kuma:latest
6    volumes:
7      - uptime-kuma-data:/app/data
8      - /var/run/docker.sock:/var/run/docker.sock:ro
9    ports:
10      - "3001:3001"
11    networks:
12      - uptime-network
13    restart: unless-stopped
14
15  nginx:
16    image: nginx:alpine
17    volumes:
18      - ./nginx.conf:/etc/nginx/nginx.conf:ro
19    ports:
20      - "80:80"
21      - "443:443"
22    depends_on:
23      - uptime-kuma
24    networks:
25      - uptime-network
26    restart: unless-stopped
27
28volumes:
29  uptime-kuma-data:
30
31networks:
32  uptime-network:
33    driver: bridge
34EOF
35
36# 2. Create the .env file
37cat > .env << 'EOF'
38# Uptime Kuma
39# First-run setup via web UI
40# Create admin account on first visit
41
42# Docker socket for container monitoring
43EOF
44
45# 3. Start the services
46docker compose up -d
47
48# 4. View logs
49docker compose logs -f

One-Liner

Run this command to download and set up the recipe in one step:

1curl -fsSL https://docker.recipes/api/recipes/uptime-kuma-status/run | bash

Troubleshooting