Skip to content
CAI
Software that uses CAICheck a score

louislam/uptime-kuma

44.7

Weak · 13 November 2026

63.8k

lines of production code

JavaScript

with TypeScript

8

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

What this system is

Features

Add PWA support with manifest, icons, and service worker

The application now supports installation as a Progressive Web App. A new manifest.json defines the app name, theme colors, and shortcuts to key pages (Dashboard, Add Monitor, etc.), while new PNG icons (192x192 and 512x512) and an SVG icon are provided for various display contexts. A service worker is introduced to handle cache management (clearing old caches) and enable push notifications, allowing users to receive monitoring alerts directly on their devices.

public · high confidence

Added push notification examples for multiple languages and environments

New example scripts have been added to the \extra/push-examples\ directory to help users set up periodic push notifications. The collection includes implementations in Bash (curl), C\#, Docker, Go, Java, JavaScript (fetch), PHP, PowerShell, Python, and TypeScript (fetch), along with a \.gitignore\ file and a README for the TypeScript example. These scripts demonstrate how to send periodic HTTP requests to a specified URL to trigger push alerts.

extra/push-examples · high confidence

Automated data retention and SQLite maintenance jobs

Two new background jobs have been introduced to manage database hygiene. The 'clear-old-data' job automatically purges expired records from the heartbeat and stat\_daily tables based on a configurable retention period (defaulting to 365 days), while the 'incremental-vacuum' job runs SQLite-specific optimization commands (incremental vacuum and WAL checkpoint) to reclaim disk space and improve performance.

server/jobs · high confidence

Automated release process with AI-generated changelogs

The release workflow in extra/release has been restructured into a modular, automated pipeline. It now includes a dedicated stage that generates release notes using an LLM to categorize changes (e.g., bug fixes, new features, security updates) and creates a draft GitHub Release. The process also automates the creation of release branches and pull requests, squash-merges them into master, builds the frontend distribution once, and pushes Docker images to both Docker Hub and GitHub Container Registry (ghcr.io). A new helper script optimizes dependency installation for the release environment by temporarily isolating only the required packages (dotenv, semver, tar).

extra/release · high confidence

Built-in DNS caching via nscd in Docker image

The Docker image now includes the Name Service Cache Daemon (nscd) to provide local DNS caching, which improves name resolution performance. A configuration file (docker/etc/nscd.conf) is added with caching enabled for the 'hosts' service and disabled for others, alongside a sudoers file (docker/etc/sudoers) that grants the 'node' user permission to start and stop the nscd service without a password.

docker/etc · high confidence

Database schema updates for new monitor types and authentication migration

The database schema has been updated to support new monitor types (NTP, TLS, SFTP, RabbitMQ, SMTP, System Service, Globalping, and manual monitors) and enhanced existing ones (MQTT, SNMP, Ping, JSON Query, and GameDig). Key changes include adding columns for NTP thresholds, TLS alerts, SFTP authentication, RabbitMQ credentials, SMTP security, and Globalping location/protocol. The GameDig monitor type has been migrated from v4 to v5 game IDs. Authentication has been migrated to Better-Auth, introducing new tables for users, sessions, accounts, and verifications, along with support for 2FA, admin roles, and username-based login. Additionally, the schema now supports configurable response data storage, websocket subprotocols, domain expiry notifications, and maintenance window tracking.

_db/knex\migrations · high confidence

Expanded notification provider support and configuration options

The notification configuration interface now supports a significantly wider range of providers, including new integrations for 360messenger, 46elks, AlertNow, Alerta, AliyunSms, AmootSMS, Bale, Bark, BearSMS, Bitrix24, Brevo, CallMeBot, Cellsynt, ClickSendSMS, ClickUp, DingDing, and Discord. Existing providers have also received enhanced configuration options, such as Discord's ability to send to forum posts or threads, DingDing's mention capabilities, and Bark's API version selection. These changes allow users to monitor their systems using a broader variety of communication channels and customize how alerts are delivered.

src/components/notifications · high confidence

Frontend application shell and core configuration

The frontend application entry point has been established with a new Vue 3 app structure. This includes the main initialization script (main.js) which registers the router, internationalization (i18n), and UI mixins, as well as the root App component that handles locale setting and country flag emoji polyfilling. The change introduces a comprehensive routing configuration (router.js) defining paths for the dashboard, settings, status pages, and maintenance management. It also adds the core internationalization setup (i18n.js) with support for numerous languages and RTL direction handling, a centralized icon library (icon.js) using FontAwesome, and shared utility modules (util.ts, util-frontend.js) for timezone management, toast notifications, and common constants.

src · high confidence

Initial database schema definition for core monitoring entities

The database initialization script now explicitly defines the schema for core tables including user, monitor, heartbeat, incident, maintenance, and status\_page. This establishes the foundational data structure for user accounts, monitoring configurations, health check records, incident tracking, scheduled maintenance windows, and public status pages, ensuring these entities are created with appropriate constraints, indexes, and foreign key relationships during setup.

db · high confidence

New UI components for API keys, badges, and certificate details

This change introduces several new Vue components in the frontend to enhance the user interface for specific features. The API Key management now uses a dedicated dialog (APIKeyDialog.vue) that allows users to set custom names and expiry dates for keys. A new Badge Link Generator (BadgeLinkGeneratorDialog.vue) provides a UI for configuring and previewing status badges with various styles and parameters. Additionally, certificate monitoring details are now displayed using new CertificateInfo and CertificateInfoRow components, which present validity status, subject, issuer, and expiration information in a structured format.

src/components · high confidence

New and extracted monitor types with condition support

This change introduces a new Manual monitor type for static status control and extracts several existing monitor implementations into dedicated files (DNS, GameDig, Globalping, Group, gRPC, MongoDB, MQTT, MSSQL, MySQL, NTP, OracleDB). For the database monitors (MSSQL, MySQL, OracleDB) and DNS, this extraction enables the new 'Monitor Conditions' feature, allowing users to define specific validation rules against query results or DNS records rather than just checking connectivity.

server/monitor-types · high confidence

New notification providers added: 360messenger, 46elks, Alerta, AlertNow, AliyunSMS, Apprise, Bale, Bark, BearSMS, Bitrix24, Brevo, CallMeBot, Cellsynt, ClickSendSMS, ClickUp, DingDing, and Webpush

The server/notification-providers directory now includes a large set of new notification provider implementations, expanding the system's ability to send alerts via WhatsApp (360messenger), SMS (46elks, AliyunSMS, AmootSMS, Bale, BearSMS, Cellsynt, ClickSendSMS), webhooks (AlertNow, Apprise, Bitrix24, ClickUp, DingDing), push notifications (Bark, Webpush), email (Brevo), and other services (Alerta, CallMeBot). These additions provide users with significantly more options for receiving uptime and status alerts through their preferred communication channels.

server/notification-providers · high confidence

New utility classes and migration status server

Added three new utility modules in server/utils: ArrayWithKey, a key-value array structure supporting push, pop, shift, and last operations; LimitQueue, which extends ArrayWithKey to automatically remove the oldest element when a size limit is exceeded; and SimpleMigrationServer, a lightweight Express server that displays migration progress and provides a /migrate-status endpoint to keep Docker healthchecks happy during server migrations.

server/utils · high confidence

New utility scripts and test infrastructure in the extra directory

The extra directory now includes a suite of new utility scripts and test helpers. This adds a Go-based healthcheck tool (with a build script) to verify server availability, and a simple DNS server for testing DNS monitoring types. It also introduces scripts to manage Pull Request testing workflows (checkout, rebase, and Docker-based PR testing), automate demo server deployments, and download distribution artifacts. Maintenance and cleanup tools are added for resetting database migration states, removing 2FA, resetting passwords, and cleaning up Playwright test data. Additionally, validation scripts ensure correct formatting for language JSON files and Knex migration filenames, and a script is provided to download the latest Apprise package.

extra · high confidence

Project initialization with comprehensive tooling and documentation

The repository is initialized with a complete development and operational setup. This includes configuration files for ESLint, Prettier, Stylelint, and TypeScript to enforce code quality and formatting standards. The frontend build is configured via Vite with support for SCSS, RTL CSS, and compression. Essential project documentation such as the README, CONTRIBUTING guide, Code of Conduct, and Security policy are added, alongside a strict policy against AI-generated code submissions. Operational assets include a Docker Compose file, a PM2 ecosystem configuration, and a Playwright setup for end-to-end testing.

(repo-wide) · high confidence

Support for multiple third-party analytics providers on status pages

Status pages can now be configured to inject tracking scripts from Google Analytics, Umami, Plausible, Matomo, and Rybbit. The server/analytics module provides the logic to validate the required configuration (IDs and script URLs) and generate the appropriate HTML script tags for each provider, allowing users to choose their preferred analytics solution.

server/analytics · high confidence

Architecture

Introduce new Vue Router-based page architecture

The application's frontend navigation has been restructured to use Vue Router, replacing the previous view-switching mechanism with dedicated page components. This change introduces new entry points for core workflows, including AddStatusPage for creating status pages, Dashboard for the main monitoring overview, Details for individual monitor information, EditMaintenance for scheduling maintenance windows, and EditMonitor for configuring monitors. This architectural shift enables cleaner URL routing, distinct component lifecycles for each page, and improved state management for the user interface.

src/pages · high confidence

Introduction of dedicated model classes for core entities

The server model layer has been refactored to use dedicated classes for core entities, replacing the previous generic usage of the base BeanModel. New model files have been introduced for API keys, Docker hosts, domain expiry, groups, heartbeats, incidents, maintenance, monitors, proxies, remote browsers, status pages, tags, and users. This change centralizes entity-specific logic, such as JSON serialization, status resolution, and data validation, within these specific model classes, improving code organization and maintainability.

server/model · high confidence

Introduction of dedicated server routers for API, authentication, and status pages

The server routing logic has been reorganized into dedicated modules: \api-router.js\ now handles push monitor heartbeats, badge generation, and entry-page resolution; \better-auth-router.ts\ manages user setup and authentication via the better-auth library; and \status-page-router.js\ serves status page views, RSS feeds, manifest files, incident history, and overall status badges. This change centralizes request handling for these specific areas, improving code structure and maintainability.

server/routers · high confidence

Refactored server socket handlers into dedicated modules

The server's socket event handling logic has been reorganized from a monolithic structure into specific, dedicated handler files (e.g., api-key, cloudflared, status-page, maintenance). This change improves code maintainability and separation of concerns by isolating the logic for distinct features like API key management, Cloudflare tunnel control, and status page incidents into their own modules.

server/socket-handlers · high confidence

Behavioural changes

2 commits (1 fix) modifying server/modules/ping

A change to existing behaviour in server/modules/ping — 2 commits (1 fix), 17 files: “chore: combine modifed node-ping and make monitor standalone (\#8060)”; “fix: ping mojibake on non-English Windows (\#8083)” (refs \#8060, \#8083).

server/modules/ping · medium confidence · unverified

Add multi-architecture support for the uptime-kuma-push binary

The Dockerfile for the extra/uptime-kuma-push component has been updated to use a multi-arch Node base image, enabling the build process to correctly select and package the appropriate precompiled binary for linux/amd64, linux/arm64, and linux/arm/v7 platforms. This change ensures the push utility runs reliably across different CPU architectures without requiring manual binary selection.

extra/uptime-kuma-push · high confidence

Archived legacy database migration scripts

The \db/old\_migrations\ directory now contains a comprehensive collection of historical SQL patches that established the core database schema. These files document the evolution of the \monitor\, \status\_page\, \user\, and \notification\ tables, including the addition of support for 2FA, Docker integration, Kafka and MQTT monitoring, gRPC checks, proxy configurations, and maintenance windows. A new README explicitly directs users to create new migrations in \db/knex\_migrations/\ instead, ensuring that these legacy patches remain as historical records without interfering with current migration workflows.

_db/old\migrations · high confidence

Docker infrastructure restructured with Node.js 26 base and Let's Encrypt Gen Y root certificates

The Docker build system has been reorganized into modular components, introducing a new Go-based healthcheck builder and a Debian-based base image layer that upgrades the runtime to Node.js 26. This update includes the manual installation of Let's Encrypt Gen Y root certificates to ensure TLS connectivity on Debian Bookworm, integrates Cloudflare's package repository for the cloudflared binary, and embeds the nscd service for improved DNS caching. The main application image now builds on this slimmed-down base, which also installs Apprise via a dedicated deb package and configures sudo permissions for the node user to manage services.

docker · high confidence

Embed axios-ntlm 1.3.0 with secure random generation

The server now includes the axios-ntlm library (version 1.3.0) directly within the project, providing NTLM authentication support for HTTP requests. This update replaces the previous pseudo-random value generation in the hash module with \crypto.randomInt\, ensuring cryptographically secure random values are used during the NTLM handshake process.

server/modules/axios-ntlm · high confidence

Initial CSS architecture and dark mode support

The application's styling has been consolidated into a new SCSS structure under src/assets, introducing a dedicated vars.scss file that defines the core color palette and dark mode variables. This change brings native dark mode support to key UI components, including the multiselect dropdowns, the Vue datepicker, and general form elements, while also establishing a specific font stack for Persian (Farsi) localization.

src/assets · high confidence

Introduce dedicated layout components for application structure

The application now uses specific layout components to manage the user interface structure. A new \EmptyLayout.vue\ provides a minimal wrapper for routes that do not require the main navigation. The primary \Layout.vue\ component establishes the core shell, featuring a desktop header with navigation links (Dashboard, Status Pages, Settings, Help) and a user dropdown, a mobile-optimized header, and a bottom navigation bar for mobile devices. It also handles connection error messaging, version update notifications, and conditional rendering of the login dialog based on authentication state.

src/layouts · high confidence

Introduction of Better Auth authentication system

The server now utilizes the Better Auth library to manage user authentication, replacing the previous custom implementation. This change introduces a new authentication architecture in the server directory, featuring dedicated modules for handling user sessions, API key verification, and basic HTTP authentication. The system supports username-based login, integrates with rate limiting for both login and API attempts, and includes a migration path to transfer existing user credentials to the new schema. Additionally, it provides a legacy login function to ensure compatibility during the transition period. Also in this area: 1 commit (1 fix) fixing (repo-wide), server; 1 commit (0 fixes) modifying server, src/components; Migrate API key management to Better Auth with expiration support; Fixes authentication setup failures and improves development environment detection; Skip HIBP check during legacy user migration; and 2 more.

server · low confidence · unverified

New frontend mixin architecture for core UI concerns

The application now uses a set of dedicated Vue mixins in src/mixins to handle specific frontend responsibilities, replacing or refactoring previous inline logic. The new datetime.js mixin centralizes date and time formatting using dayjs with support for user-selected or auto-detected timezones. The lang.js mixin manages dynamic language switching and locale updates. The mobile.js mixin handles responsive layout adjustments by detecting screen width. The public.js mixin provides shared data and computed properties for public-facing status pages. The socket.js mixin manages real-time WebSocket connections, event handling, and UI state synchronization. The theme.js mixin controls dark/light mode application, status page theming, and theme-color meta tag updates. This refactoring improves code organization and maintainability for these core UI features.

src/mixins · high confidence

Settings page restructured into modular components

The Settings page has been refactored from a single monolithic view into a set of distinct, component-based sections (API Keys, About, Appearance, Docker, General, Monitor History, Notifications, Proxies, Remote Browsers, Reverse Proxy, Security, and Tags). This change improves the organization and maintainability of the settings interface, allowing users to navigate specific configuration areas more clearly while preserving all existing functionality such as API key management, theme selection, proxy configuration, and notification settings.

src/components/settings · high confidence

Fixes

1 commit (1 fix) fixing server/modules/prometheus-api-metrics

A fix in server/modules/prometheus-api-metrics — 1 commit (1 fix), 6 files: “fix: reduce cpu usage, disable the /metrics endpoint by default (\#8041)” (refs \#8041).

server/modules/prometheus-api-metrics · medium confidence · unverified

Fix default value support for TEXT columns in MariaDB

The MySQL2 dialect compiler now correctly generates SQL for setting default values on TEXT fields when using MariaDB. Previously, Knex could not set defaults for these columns; the new implementation wraps the default value in an expression syntax (e.g., \default (...)\) to comply with MariaDB 10.2+ requirements, ensuring schema migrations involving TEXT defaults succeed.

server/utils/knex · high confidence

Test coverage

4 commits adding/updating tests in test/frontend-test; Added E2E test utilities for screenshots and database snapshots; Added gRPC manual test infrastructure; Added manual test infrastructure for Redis TLS connectivity; Added test infrastructure for Radius and database mocking; Added tests for Indigo provider, NTLM hash utility, and error handling; Added tests for monitor condition expression evaluation and operators; Added unit tests for backend monitor types; Expanded E2E test coverage for core application features; Expanded backend test coverage for new monitor types and infrastructure.

Dependencies

Uptime Kuma 3.0.0 Beta: Major dependency overhaul and Node.js 26 upgrade

This release upgrades the application to version 3.0.0-beta.0, requiring Node.js 26.2.0 or later. The dependency tree has been significantly modernized: the database backend has migrated from node-sqlite3 to better-sqlite3, and authentication has switched from bcryptjs to better-auth. Frontend tooling has been updated to Vite 5.4.15 with Vue 3.4, and testing infrastructure now uses Playwright 1.61.1. Additionally, several new utility packages were added to the \extra/\ directory, including \docker-latest-warning\, \kuma-pr\, and \uptime-kuma-push\ for build and release automation.

(dependencies) · high confidence

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

How this codebase got here

This is the PUBLIC form of this artifact. Findings are listed in full, but the details of SECURITY findings — which rule fired, in which file, on which line, and how to fix it — are deliberately withheld, and any secret-scanner results are excluded entirely. Where detail is absent here it was REMOVED FOR PUBLICATION; it is not missing from the analysis. The complete artifact is available from the repository owner.

Score

  • CAI 42 → 45 (+2.5)
  • Rubric changed (rubric-2026.10.5 → rubric-2026.11.3) — scores are not directly comparable.

Lenses

  • Code Health 46 → 46 (-0.3)
  • Architecture 73 → 73 (+0.5)
  • Maturity 57 → 58 (+0.8)
  • Readiness 33 → 37 (+3.7)
  • Security 60 → 65 (+5.1)
  • Accessibility 47 → 52 (+5.1)
  • Performance 60 → 60 (+0.0)

Resolved (80)

  • (anonymous) (cognitive 109) (server/server.js)
  • (anonymous) (cognitive 16) (src/modules/dayjs/plugin/timezone/index.js)
  • (anonymous) (cognitive 18) (server/modules/dayjs/plugin/timezone.js)
  • (anonymous) (cognitive 22) (server/routers/api-router.js)
  • (anonymous) (cyclomatic 17) (src/modules/dayjs/plugin/timezone/index.js)
  • (anonymous) (cyclomatic 18) (server/routers/api-router.js)
  • (anonymous) (cyclomatic 20) (server/modules/dayjs/plugin/timezone.js)
  • (anonymous) (cyclomatic 82) (server/server.js)
  • Change coupling: server.js ↔ General.vue (server/server.js)
  • Critical CVE: [GHSA redacted] (package-lock.json)
  • Critical CVE: [GHSA redacted] (package-lock.json)
  • Critical CVE: [GHSA redacted] (package-lock.json)
  • Critical vulnerability: [GHSA redacted] (package-lock.json)
  • Deprecated: lodash.get (package-lock.json)
  • Deprecated: tar (package.json)
  • Deprecated: uuid (package-lock.json)
  • Deprecated: uuid (package-lock.json)
  • Documentation: no contributor guidance (README.md)
  • Documentation: no project overview (README.md)
  • FunctionTooLong: index.default (src/modules/dayjs/plugin/timezone/index.js)
  • …and 60 more

New (79)

  • (anonymous) (cognitive 116) (server/server.js)
  • (anonymous) (cognitive 24) (server/routers/api-router.js)
  • (anonymous) (cyclomatic 20) (server/routers/api-router.js)
  • (anonymous) (cyclomatic 86) (server/server.js)
  • Change coupling: uptime-kuma-server.ts ↔ General.vue (server/uptime-kuma-server.ts)
  • Documentation: no map of the repository's parts (README.md)
  • FileTooLong: routers/api-router.js (server/routers/api-router.js)
  • High CVE: [GHSA redacted] (package-lock.json)
  • Hotspot: server/model/monitor.js (server/model/monitor.js)
  • Hotspot: server/routers/api-router.js (server/routers/api-router.js)
  • Hotspot: src/components/MonitorList.vue (src/components/MonitorList.vue)
  • Low CVE: [GHSA redacted] (package-lock.json)
  • Low cohesion: UptimeKumaServer (LCOM4 4) (server/uptime-kuma-server.ts)
  • Medium CVE: [GHSA redacted] (package-lock.json)
  • Medium CVE: [GHSA redacted] (package-lock.json)
  • Medium CVE: [GHSA redacted] (package-lock.json)
  • Medium CVE: [GHSA redacted] (package-lock.json)
  • Medium CVE: [GHSA redacted] (package-lock.json)
  • Medium CVE: [GHSA redacted] (package-lock.json)
  • Medium: security finding (details withheld)
  • …and 59 more

Changes since last survey

  • 78 commits — 55 feature/other, 23 fixes

By area

  • (root) — 16 commits
  • src/lang — 16 commits
  • test/backend-test — 11 commits
  • (repo) — 8 commits
  • server/modules — 4 commits
  • .github/workflows — 3 commits
  • server/routers — 3 commits
  • .github/opencode-models.json — 2 commits
  • extra/release — 2 commits
  • server/docker.js — 2 commits
  • server/model — 2 commits
  • src/components — 2 commits
  • .github/copilot-instructions.md — 1 commit
  • extra/check-knex-filenames.mjs — 1 commit
  • server/database.js — 1 commit
  • src/beat-state.ts — 1 commit
  • src/mixins — 1 commit
  • src/pages — 1 commit
  • test/e2e — 1 commit

Notable commits

  • fix: chore: fix nightly release tar import (#8135)
  • fix: chore: reduce Docker image size, fix real browser and embedded MariaDB (#8040)
  • fix: fix: Correct filter and monitor count (#7985)
  • fix: fix: Docker verification check sometimes not catching invalid responses (#8048)
  • fix: fix: Docker verification check sometimes not catching invalid responses (2.5.X backport) (#8049)
  • fix: fix: add next-slim-rootless docker tag to 2.5.X too (#8038)
  • fix: fix: better-auth 1.7.x and promisify-child-process regessions (#8136)
  • fix: fix: dashboard live updates issues (#8046)
  • fix: fix: honor DOCKER_TLS_DIR_PATH (#7966)
  • fix: fix: ignore client-supplied X-Forwarded-For when Trust Proxy is off (#8110)
  • fix: fix: make session cookies Secure on HTTPS (#8090)
  • fix: fix: ping mojibake on non-English Windows (#8083)
  • fix: fix: reduce cpu usage, disable the /metrics endpoint by default (#8041)
  • fix: fix: regression - incorrect uptime badge color in status pages (#8141)
  • fix: fix: regression: push monitors doesn't update live data (#8163)
  • fix: fix: regression: uptime percentages don't update (#8149)
  • fix: fix: reject malformed migration filename prefixes (#7982)
  • fix: fix: remove duplicated refresh timer on status page (#8079)
  • fix: fix: reset push monitor retries from the last stored heartbeat (#8081)
  • fix: fix: runtime timeout fallback used milliseconds for a seconds field (#8082)
  • …and 58 more

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

Survey your own repository

louislam/uptime-kuma was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.

About this page

  • The score is its most recent published measurement, taken on 13 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
  • Measured at commit 7f4e873c899b4759dd45981c63594b8cfc64c802 — the exact code this score is about.
  • Scored under rubric-2026.11.3 — the same rubric and the same method as every other entry in this index.
  • Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.61+preprod-f3449e6eb431.