Repository navigation
feat: add Uptime Kuma uptime monitoring service #50
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Changes from all commits
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -2,6 +2,9 @@ | |
|
|
||
| ## [Unreleased] | ||
|
|
||
| ### Fixed | ||
| - **Uptime Kuma** - Self-hosted uptime monitoring with 90+ notification services | ||
|
|
||
|
Comment on lines
+5
to
+7
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Move this entry from Uptime Kuma is a new capability, so this should be documented under As per coding guidelines, CHANGELOG entries should follow semantic categories ( 🤖 Prompt for AI Agents |
||
| ## [1.3.3] - 2026-02-27 | ||
|
|
||
| ### Fixed | ||
|
|
||
| Original file line number | Diff line number | Diff line change | ||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
|
@@ -107,6 +107,11 @@ import /etc/caddy/addons/tls-snippet.conf | |||||||||||||||||||
| reverse_proxy temporal-ui:8080 | ||||||||||||||||||||
| } | ||||||||||||||||||||
|
|
||||||||||||||||||||
| # Uptime Kuma | ||||||||||||||||||||
| {$UPTIME_KUMA_HOSTNAME} { | ||||||||||||||||||||
| reverse_proxy uptimekuma:3001 | ||||||||||||||||||||
| } | ||||||||||||||||||||
|
Comment on lines
+110
to
+113
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Fix Uptime Kuma Caddy block: missing TLS import and wrong upstream hostname. This block currently skips the shared TLS snippet and proxies to a non-existent upstream name. Suggested fix # Uptime Kuma
{$UPTIME_KUMA_HOSTNAME} {
- reverse_proxy uptimekuma:3001
+ import service_tls
+ reverse_proxy uptime-kuma:3001
}Also ensure As per coding guidelines, all Caddyfile service blocks must use 📝 Committable suggestion
Suggested change
🤖 Prompt for AI Agents |
||||||||||||||||||||
|
|
||||||||||||||||||||
| # Databasus | ||||||||||||||||||||
| {$DATABASUS_HOSTNAME} { | ||||||||||||||||||||
| import service_tls | ||||||||||||||||||||
|
|
||||||||||||||||||||
| Original file line number | Diff line number | Diff line change | ||||
|---|---|---|---|---|---|---|
|
|
@@ -112,6 +112,8 @@ The installer also makes the following powerful open-source tools **available fo | |||||
|
|
||||||
| ✅ [**Supabase**](https://supabase.com/) - An open-source alternative to Firebase, providing database storage, user authentication, and more. It's a popular choice for AI applications. | ||||||
|
|
||||||
| ✅ [**Uptime Kuma**](https://github.com/louislam/uptime-kuma - Self-hosted uptime monitoring tool with notifications | ||||||
|
|
||||||
|
Comment on lines
+115
to
+116
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Fix malformed Markdown link for Uptime Kuma. The link is missing the closing Suggested fix-✅ [**Uptime Kuma**](https://github.com/louislam/uptime-kuma - Self-hosted uptime monitoring tool with notifications
+✅ [**Uptime Kuma**](https://github.com/louislam/uptime-kuma) - Self-hosted uptime monitoring tool with notifications📝 Committable suggestion
Suggested change
🤖 Prompt for AI Agents |
||||||
| ✅ [**WAHA**](https://waha.devlike.pro/) - WhatsApp HTTP API (REST API) that you can configure in a click! 3 engines: WEBJS (browser based), NOWEB (websocket nodejs), GOWS (websocket go). | ||||||
|
|
||||||
| ✅ [**Weaviate**](https://weaviate.io/) - An open-source AI-native vector database with a focus on scalability and ease of use. It can be used for RAG, hybrid search, and more. | ||||||
|
|
||||||
| Original file line number | Diff line number | Diff line change | ||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
|
@@ -1276,3 +1276,18 @@ services: | |||||||||||||||||||||
| timeout: 10s | ||||||||||||||||||||||
| retries: 5 | ||||||||||||||||||||||
| start_period: 30s | ||||||||||||||||||||||
|
|
||||||||||||||||||||||
| uptime-kuma: | ||||||||||||||||||||||
| image: louislam/uptime-kuma:2 | ||||||||||||||||||||||
| container_name: uptime-kuma | ||||||||||||||||||||||
| profiles: ["uptime-kuma"] | ||||||||||||||||||||||
| restart: unless-stopped | ||||||||||||||||||||||
| environment: | ||||||||||||||||||||||
| UPTIME_KUMA_WS_ORIGIN_CHECK: bypass | ||||||||||||||||||||||
|
Comment on lines
+1285
to
+1286
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Inherit shared proxy env for outbound notifications. Uptime Kuma performs outbound HTTP calls (webhooks/alerts), so it should inherit the shared proxy anchor like other outbound services. Suggested fix environment:
+ <<: *proxy-env
UPTIME_KUMA_WS_ORIGIN_CHECK: bypassAs per coding guidelines, services making outbound HTTP requests must use the shared proxy anchor 📝 Committable suggestion
Suggested change
🤖 Prompt for AI Agents |
||||||||||||||||||||||
| volumes: | ||||||||||||||||||||||
| - uptime_kuma_data:/app/database | ||||||||||||||||||||||
|
Comment on lines
+1287
to
+1288
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Declare This service references a named volume that isn’t declared, which can fail compose validation/start. Suggested fix volumes:
appsmith_data:
+ uptime_kuma_data:
caddy-config:🤖 Prompt for AI Agents |
||||||||||||||||||||||
| healthcheck: | ||||||||||||||||||||||
| test: ["CMD-SHELL", "wget -qO- http://localhost:3000/ || exit 1"] | ||||||||||||||||||||||
| interval: 30s | ||||||||||||||||||||||
| timeout: 10s | ||||||||||||||||||||||
| retries: 5 | ||||||||||||||||||||||
|
Comment on lines
+1289
to
+1293
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Align healthcheck with actual service port and bypass proxy vars. Current healthcheck target ( Suggested fix healthcheck:
- test: ["CMD-SHELL", "wget -qO- http://localhost:3000/ || exit 1"]
+ test: ["CMD-SHELL", "http_proxy= https_proxy= HTTP_PROXY= HTTPS_PROXY= wget -qO- http://localhost:3001/ || exit 1"]
interval: 30s
timeout: 10s
retries: 5As per coding guidelines, healthchecks must bypass proxy by clearing 📝 Committable suggestion
Suggested change
🤖 Prompt for AI Agents |
||||||||||||||||||||||
| Original file line number | Diff line number | Diff line change | ||||
|---|---|---|---|---|---|---|
|
|
@@ -67,6 +67,7 @@ base_services_data=( | |||||
| "ragflow" "RAGFlow (Deep document understanding RAG engine)" | ||||||
| "searxng" "SearXNG (Private Metasearch Engine)" | ||||||
| "supabase" "Supabase (Backend as a Service)" | ||||||
| "uptimekuma" "Uptime Kuma (Uptime Monitoring)" | ||||||
|
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Use the exact compose profile id in wizard (
Suggested fix- "uptimekuma" "Uptime Kuma (Uptime Monitoring)"
+ "uptime-kuma" "Uptime Kuma (Uptime Monitoring)"📝 Committable suggestion
Suggested change
🤖 Prompt for AI Agents |
||||||
| "waha" "WAHA – WhatsApp HTTP API (NOWEB engine)" | ||||||
| "weaviate" "Weaviate (Vector Database with API Key Auth)" | ||||||
| ) | ||||||
|
|
||||||
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -103,6 +103,9 @@ fi | |
| if is_profile_active "postiz"; then | ||
| echo -e " ${GREEN}*${NC} ${WHITE}Postiz${NC}: Create your account on first login" | ||
| fi | ||
| if is_profile_active "uptime_kuma"; then | ||
| echo -e " ${GREEN}*${NC} ${WHITE}Uptime Kuma${NC}: Register your account on first login" | ||
| fi | ||
|
Comment on lines
+106
to
+108
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Profile name mismatch prevents Uptime Kuma guidance from showing. The check uses Suggested fix-if is_profile_active "uptime_kuma"; then
+if is_profile_active "uptime-kuma"; thenAs per coding guidelines, scripts should use 🤖 Prompt for AI Agents |
||
| if is_profile_active "gost"; then | ||
| echo -e " ${GREEN}*${NC} ${WHITE}Gost Proxy${NC}: Routing AI traffic through external proxy" | ||
| fi | ||
|
|
||
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -354,6 +354,16 @@ if is_profile_active "postiz"; then | |
| }") | ||
| fi | ||
|
|
||
| # Uptime Kuma | ||
| if is_profile_active "uptime-kuma"; then | ||
| SERVICES_ARRAY+=(" \"uptime-kuma\": { | ||
| \"hostname\": \"$(json_escape "$UPTIMEKUMA_HOSTNAME")\", | ||
| \"credentials\": { | ||
| \"note\": \"Create account on first login\" | ||
| } | ||
| }") | ||
| fi | ||
|
Comment on lines
+357
to
+365
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Use the correct env var for Uptime Kuma hostname.
Suggested fix- \"hostname\": \"$(json_escape "$UPTIMEKUMA_HOSTNAME")\",
+ \"hostname\": \"$(json_escape "$UPTIME_KUMA_HOSTNAME")\",🤖 Prompt for AI Agents |
||
|
|
||
| # WAHA | ||
| if is_profile_active "waha"; then | ||
| SERVICES_ARRAY+=(" \"waha\": { | ||
|
|
||
| Original file line number | Diff line number | Diff line change | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
|
@@ -420,6 +420,14 @@ | |||||||||||||||||||||||
| category: 'tools', | ||||||||||||||||||||||||
| docsUrl: 'https://docs.python.org' | ||||||||||||||||||||||||
| }, | ||||||||||||||||||||||||
| 'uptime-kuma': { | ||||||||||||||||||||||||
| name: 'Uptime Kuma', | ||||||||||||||||||||||||
| description: 'Uptime Monitoring Dashboard', | ||||||||||||||||||||||||
| icon: 'UK', | ||||||||||||||||||||||||
| color: 'bg-[#5CDD8B]', | ||||||||||||||||||||||||
| category: 'monitoring', | ||||||||||||||||||||||||
| docsUrl: 'https://github.com/louislam/uptime-kuma' | ||||||||||||||||||||||||
| } | ||||||||||||||||||||||||
| 'cloudflare-tunnel': { | ||||||||||||||||||||||||
|
Comment on lines
+430
to
431
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. 🧩 Analysis chain🏁 Script executed: #!/bin/bash
# Verify the exact missing-comma pattern between uptime-kuma and cloudflare-tunnel entries.
rg -nP -C2 "docsUrl:\s*'https://github.com/louislam/uptime-kuma'\s*\n\s*}\s*\n\s*'cloudflare-tunnel':\s*{" welcome/app.jsRepository: kossakovsky/n8n-install Length of output: 49 🏁 Script executed: # First, check if the file exists and find the SERVICE_METADATA object
fd -p welcome/app.jsRepository: kossakovsky/n8n-install Length of output: 81 🏁 Script executed: # Search for uptime-kuma entry to locate it precisely
rg -n "uptime-kuma" welcome/app.js -A 8 -B 2Repository: kossakovsky/n8n-install Length of output: 785 🏁 Script executed: # Also check the cloudflare-tunnel entry context
rg -n "cloudflare-tunnel" welcome/app.js -A 3 -B 3Repository: kossakovsky/n8n-install Length of output: 351 Add a comma after the Line 430 closes the Proposed fix 'uptime-kuma': {
name: 'Uptime Kuma',
description: 'Uptime Monitoring Dashboard',
icon: 'UK',
color: 'bg-[`#5CDD8B`]',
category: 'monitoring',
docsUrl: 'https://github.com/louislam/uptime-kuma'
- }
+ },
'cloudflare-tunnel': {📝 Committable suggestion
Suggested change
🧰 Tools🪛 Biome (2.4.6)[error] 431-431: expected (parse) 🤖 Prompt for AI Agents |
||||||||||||||||||||||||
| name: 'Cloudflare Tunnel', | ||||||||||||||||||||||||
| description: 'Zero-Trust Network Access', | ||||||||||||||||||||||||
|
|
||||||||||||||||||||||||
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Correct the hostname variable typo (
HOSTNME→HOSTNAME).UPTIME_KUMA_HOSTNMEwon’t be read by components usingUPTIME_KUMA_HOSTNAME, so host routing/config will break.Suggested fix
As per coding guidelines, all service hostnames must end with
_HOSTNAMEsuffix.📝 Committable suggestion
🧰 Tools
🪛 dotenv-linter (4.0.0)
[warning] 186-186: [UnorderedKey] The UPTIME_KUMA_HOSTNME key should go before the USER_DOMAIN_NAME key
(UnorderedKey)
🤖 Prompt for AI Agents
Add
uptime-kumatoGOST_NO_PROXY.Since this PR introduces a new service container, it must be added to the internal bypass list to avoid proxying intra-stack traffic.
Suggested fix
As per coding guidelines, all service container names must be listed in
GOST_NO_PROXYin.env.example.🧰 Tools
🪛 dotenv-linter (4.0.0)
[warning] 186-186: [UnorderedKey] The UPTIME_KUMA_HOSTNME key should go before the USER_DOMAIN_NAME key
(UnorderedKey)
🤖 Prompt for AI Agents