schema_version: 6
publication_status: published

slug: uptime-kuma
name: Uptime Kuma
tagline: Uptime monitoring for websites, ports, and certificates
summary: >-
  Uptime Kuma checks HTTP endpoints, TCP ports, DNS, ping, and certificate expiry, then notifies you through Telegram, email, or a webhook. It also publishes status pages. One container and a local Docker volume are enough.

status: active
editorial_status: recommended

links:
  website: https://uptimekuma.org/
  source: https://github.com/louislam/uptime-kuma
  documentation: https://github.com/louislam/uptime-kuma/wiki
  issues: https://github.com/louislam/uptime-kuma/issues

classification:
  categories:
    - Monitoring
  tags:
    - uptime
    - status-page
    - notifications
    - homelab
  implementation_languages:
    - JavaScript
  alternatives_to:
    - UptimeRobot
    - Better Uptime
    - Pingdom

license:
  spdx: MIT
  kind: open_source
  restrictions: []
  notes: null

localization:
  ui_languages:
    - en
    - ru
  docs_languages:
    - en

clients:
  web: true
  android: false
  ios: false
  desktop: false

auth:
  oidc: none
  saml: none
  two_factor: native
  proxy_header: false

requirements:
  architectures:
    - amd64
    - arm64
    - armv7
  min_cpu_cores: 1
  min_ram_mb: 512
  recommended_ram_mb: 1024
  min_disk_gb: 2
  gpu:
    required: false
    supported: false
  database: sqlite
  dependencies: []

operations:
  install_difficulty: 1
  installation_levels:
    home: supported
    vps: supported
    reliable: unsupported
  maintenance_difficulty: 2
  backup_supported: true
  restore_tested: true
  healthcheck: true
  reverse_proxy_required: false
  update_complexity: in_place

recipe:
  id: uptime-kuma-compose
  version: 3
  compose_file: compose.yaml
  env_example: .env.example
  installation: installation.md
  troubleshooting: troubleshooting.md
  supported_docker_compose: ">=2.24.0"
  application_version: 2.5.7
  images:
    - name: louislam/uptime-kuma
      tag_source: env
  tested_at: "2026-10-25"
  tested_architectures:
    amd64: passed
    arm64: not_tested
    armv7: not_tested
  smoke_test: full
  check_history:
    - tested_at: "2026-10-25"
      application_version: 2.5.7
      recipe_version: 3
      tested_architectures:
        amd64: passed
        arm64: not_tested
        armv7: not_tested
      smoke_test: full
      restore_tested: true
    - tested_at: "2026-10-09"
      application_version: 2.5.5
      recipe_version: 2
      tested_architectures:
        amd64: passed
        arm64: not_tested
        armv7: not_tested
      smoke_test: full
      restore_tested: true
    - tested_at: "2026-08-30"
      application_version: 2.5.3
      recipe_version: 1
      tested_architectures:
        amd64: passed
        arm64: not_tested
        armv7: not_tested
      smoke_test: full
      restore_tested: true
  license: MIT
  smoke_test_limitations:
    - The application smoke test, including backup and restore, passed on amd64 on 2026-10-25. arm64 and armv7 were not tested in this run.

security:
  public_exposure: supported
  default_bind: localhost
  privileged: false
  host_network: false
  docker_socket: false
  known_risks:
    - Monitoring Docker containers needs Docker API access, which this recipe does not grant; add it through a restricted socket proxy, because the raw socket is equivalent to root on the host.
  assessment:
    status: warnings
    assessed_at: "2026-08-30"

upstream:
  release_source: github
  repository: louislam/uptime-kuma
  last_release_at: "2026-10-23"
  last_checked_at: "2026-10-25T15:20:27.352Z"
  stars: 90771
  stars_checked_at: "2026-08-30T13:17:43Z"
  releases_last_year: 18
  releases_checked_at: "2026-10-25T15:20:27.352Z"

update_tracking:
  releases:
    status: current
    checked_at: "2026-10-25T15:20:27.352Z"
    latest_version: 2.5.7
  critical_vulnerabilities:
    status: findings
    checked_at: "2026-10-25T15:21:03.910Z"
    critical_count: 13
    scanner: trivy
    ids:
      - CVE-2023-45853
      - CVE-2024-24790
      - CVE-2025-68121
      - CVE-2025-7458
      - CVE-2026-102267
      - CVE-2026-102268
      - CVE-2026-40468
      - CVE-2026-40469
      - CVE-2026-41242
      - CVE-2026-58016
      - CVE-2026-59873
      - CVE-2026-6653
  breaking_updates:
    status: unknown
    checked_at: null
  compose_changes:
    status: not_tracked
    checked_at: null
  outdated_images:
    status: current
    checked_at: "2026-10-25T15:20:27.352Z"
    images: []
update_policy:
  images:
    - image: louislam/uptime-kuma
      provider: docker_hub
      repository: louislam/uptime-kuma
  compose: null

content:
  description: description.md
  logo: assets/logo.svg
  screenshots:
    - file: assets/dashboard.webp
      alt: Uptime Kuma dashboard showing monitor groups and a response chart in dark theme
    - file: assets/monitor.webp
      alt: A single monitor with its heartbeat history and response time chart in light theme
    - file: assets/add-monitor.webp
      alt: The add-monitor form with check type, interval, and HTTP options
    - file: assets/status-page.webp
      alt: A public status page listing services and their current availability
  updated_at: "2026-10-25"