diff --git a/cc-ci-plan/upstream/uptime-kuma.md b/cc-ci-plan/upstream/uptime-kuma.md
new file mode 100644
index 0000000..0d3fcb8
--- /dev/null
+++ b/cc-ci-plan/upstream/uptime-kuma.md
@@ -0,0 +1,13 @@
+# Upstream sources — uptime-kuma
+
+| service | image | source repo | releases / changelog |
+|---------|-------|-------------|----------------------|
+| app     | louislam/uptime-kuma | https://github.com/louislam/uptime-kuma | https://github.com/louislam/uptime-kuma/releases |
+| db      | mariadb | https://github.com/MariaDB/server | https://mariadb.org/ |
+
+## Standing notes
+- uptime-kuma 2.3.0 removed status-page sorting (performance issue); no migration needed.
+- uptime-kuma 2.3.2 reverted SQLite to single-connection mode; Raspberry Pi users may need `UPTIME_KUMA_SQLITE_SINGLE_CONNECTION=true`.
+- MariaDB 12.x is a stable long-term release series (12.3.2 released 2026-05-28).
+- compose.mariadb.yml is an optional overlay for MariaDB backend; the default recipe uses SQLite (compose.yml only). The cc-ci tests use the default SQLite path.
+- A one-step major jump from 11.8 → 12.x is safe for fresh deployments; for existing MariaDB deployments, test the upgrade path.