feat(kuma-sync): ship the KumaStatusPage CRD, RBAC and the renner page

The CRD and the ClusterRole rules land with the controller change, so
Flux applies them at merge, before the new kuma-sync image is built and
rolled out by the ImagePolicy; the new controller watches
KumaStatusPage and would not start without them.

- infrastructure/kuma-sync-crds: crd-kumastatuspages.yaml, a copy of
  config/crd with prune disabled, next to crd-kumamonitors.yaml.
- apps/kuma-sync/rbac.yaml: kumastatuspages, /status, /finalizers, as in
  config/rbac/role.yaml.
- apps/kuma-sync/statuspage-renner.yaml: the public page (slug renner,
  domain uptime.renner.uno) with the sections Services and Third-party,
  selected by the uptime.renner.uno/status-page-section label.
- The label on the 17 top-level service groups and the four third-party
  HTTP checks.

An envtest test validates the deployed page object against the CRD.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

.woodpecker/alert-monitor.yml

@@ -31,7 +31,7 @@
 #   - cron   : a cron NAMED exactly "alert-monitor" (name filter, same
 #              mechanism as update-audit.yml):
 #                woodpecker repo cron add --repo konairius/homelab \
-#                  --name alert-monitor --branch master --schedule '*/15 * * * *'
+#                  --name alert-monitor --branch main --schedule '*/15 * * * *'
 #   - deploy : woodpecker-cli pipeline deploy konairius/homelab <n> alert-monitor
 #              where <n> is an existing pipeline to promote.
 when:

.woodpecker/build-ci-images.yml

@@ -27,7 +27,7 @@
 # Note this pipeline runs no LLM agent, so the exfil path that motivated the
 # other cutovers does not apply to it.
 #
-# Push builds run on master only. Without the branch filter a feature branch
+# Push builds run on main only. Without the branch filter a feature branch
 # that touches this file started all steps at once: it pushed unreviewed
 # images and used the whole woodpecker-ci-quota, so the PR checks could not
 # get a pod (REN-286).
@@ -36,7 +36,7 @@
 # image, and in parallel they exceed the woodpecker-ci-quota.
 when:
   - event: push
-    branch: master
+    branch: main
     path:
       - "ci/images/**"
       - "secret-rotator/**"

.woodpecker/ci-claude-refresh.yml

@@ -46,20 +46,20 @@
 #                                push/cron/manual events this pipeline fires on.
 #
 # OWNER SETUP — the token + secret above are already provisioned. The one
-# remaining step, to be run AFTER this merges to master (a cron references a
+# remaining step, to be run AFTER this merges to main (a cron references a
 # pipeline that must exist on the target branch), is to register the schedule:
 #   woodpecker repo cron add --repo konairius/homelab \
-#     --name ci-claude-refresh --branch master --schedule '@weekly'
+#     --name ci-claude-refresh --branch main --schedule '@weekly'
 # Weekly is plenty; the pipelines tolerate being a few days behind a release.
 #
 # Triggering:
 #   - cron   : the cron NAMED exactly "ci-claude-refresh" (see above).
 #   - deploy : woodpecker-cli pipeline deploy konairius/homelab <n> ci-claude-refresh
 #              where <n> is an existing pipeline to promote.
-#   - push   : a change to the Containerfile (or this file) ON master forces a
+#   - push   : a change to the Containerfile (or this file) ON main forces a
 #              rebuild of the current latest version so Containerfile fixes ship
-#              promptly. Restricted to master ON PURPOSE — a feature branch must
-#              never build/push an image or open a bump PR (only master pushes
+#              promptly. Restricted to main ON PURPOSE — a feature branch must
+#              never build/push an image or open a bump PR (only main pushes
 #              images), and without this filter every PR that edits these paths
 #              would do exactly that from its own branch.
 when:
@@ -68,7 +68,7 @@ when:
   - event: deployment
     evaluate: 'CI_PIPELINE_DEPLOY_TARGET == "ci-claude-refresh"'
   - event: push
-    branch: master
+    branch: main
     path:
       - "ci/images/claude/**"
       - ".woodpecker/ci-claude-refresh.yml"
@@ -208,7 +208,7 @@ steps:
         jq -n --arg title "chore(ci): bump ci-claude image to $$NEW" \
               --rawfile body /tmp/pr-body.md \
               --arg head "$$BRANCH" \
-          '{title: $$title, body: $$body, head: $$head, base: "master"}' > /tmp/pr.json
+          '{title: $$title, body: $$body, head: $$head, base: "main"}' > /tmp/pr.json
         code=$$(curl -s -o /tmp/resp.json -w '%{http_code}' \
           -X POST -H "Authorization: token $$PUSH_TOKEN" \
           -H "Content-Type: application/json" --data @/tmp/pr.json "$$API/pulls")

.woodpecker/deploy-claude-workstation.yml

@@ -1,7 +1,7 @@
 when:
-  # Deploy only on master (merge) + manual — never auto-deploy from a branch.
+  # Deploy only on main (merge) + manual — never auto-deploy from a branch.
   - event: push
-    branch: master
+    branch: main
     path:
       - "ansible/roles/claude-workstation/**"
       - "ansible/plays/install-claude-workstation.yml"

.woodpecker/deploy-edge-mqtt-bridge.yml

@@ -1,7 +1,7 @@
 when:
-  # Deploy only on master (merge) + manual — never auto-deploy from a branch.
+  # Deploy only on main (merge) + manual — never auto-deploy from a branch.
   - event: push
-    branch: master
+    branch: main
     path:
       - "ansible/roles/mqtt-bridge/**"
       - "ansible/plays/edge-mqtt-bridge.yml"

.woodpecker/deploy-infrastructure.yml

@@ -1,10 +1,10 @@
 when:
-  # Plan only on master (merge) + manual — a push trigger without this gate
+  # Plan only on main (merge) + manual — a push trigger without this gate
   # would run `tofu plan` (which evaluates provider/data-source code) with
   # all proxmox/hetzner/unifi secrets mounted for any pushed branch,
   # including malicious feature-branch .tf.
   - event: push
-    branch: master
+    branch: main
     path:
       - "opentofu/**"
       - ".woodpecker/deploy-infrastructure.yml"

.woodpecker/deploy-netbird-client.yml

@@ -1,7 +1,7 @@
 when:
-  # Deploy only on master (merge) + manual — never auto-deploy from a branch.
+  # Deploy only on main (merge) + manual — never auto-deploy from a branch.
   - event: push
-    branch: master
+    branch: main
     path:
       - "ansible/roles/netbird-client/**"
       - "ansible/plays/install-netbird-client.yml"

.woodpecker/deploy-netbird-proxy.yml

@@ -1,7 +1,7 @@
 when:
-  # Deploy only on master (merge) + manual — never auto-deploy from a branch.
+  # Deploy only on main (merge) + manual — never auto-deploy from a branch.
   - event: push
-    branch: master
+    branch: main
     path:
       - "ansible/roles/netbird-proxy/**"
       # install-netbird-proxy.yml also applies the netbird-proxy-watchdog role,

.woodpecker/deploy-netbird-server.yml

@@ -1,7 +1,7 @@
 when:
-  # Deploy only on master (merge) + manual — never auto-deploy from a branch.
+  # Deploy only on main (merge) + manual — never auto-deploy from a branch.
   - event: push
-    branch: master
+    branch: main
     path:
       - "ansible/roles/netbird-server/**"
       - "ansible/plays/install-netbird-server.yml"

.woodpecker/deploy-uptime-kuma.yml

@@ -1,7 +1,7 @@
 when:
-  # Deploy only on master (merge) + manual — never auto-deploy from a branch.
+  # Deploy only on main (merge) + manual — never auto-deploy from a branch.
   - event: push
-    branch: master
+    branch: main
     path:
       - "ansible/roles/uptime-kuma/**"
       - "ansible/plays/install-uptime-kuma.yml"

.woodpecker/hermes-image.yml

@@ -2,7 +2,7 @@
 # gitea.renner.uno/konairius/hermes:build.<unix-ts> and :latest.
 when:
   - event: push
-    branch: master
+    branch: main
     path:
       - "ci/images/hermes/**"
       - ".woodpecker/hermes-image.yml"

.woodpecker/issue-fix.yml

@@ -33,7 +33,7 @@
 # Triggering:
 #   - cron   : a cron NAMED exactly "issue-fix":
 #                woodpecker repo cron add --repo konairius/homelab \
-#                  --name issue-fix --branch master --schedule '41 * * * *'
+#                  --name issue-fix --branch main --schedule '41 * * * *'
 #   - deploy : woodpecker-cli pipeline deploy konairius/homelab <n> issue-fix
 #              where <n> is an existing pipeline to promote.
 when:
@@ -199,7 +199,7 @@ steps:
         git push "https://$$PUSH_TOKEN@gitea.renner.uno/konairius/homelab.git" HEAD:"$$BRANCH"
         jq -n --arg title "$$TITLE" --rawfile body /tmp/alert-fix/summary.md \
           --arg head "$$BRANCH" \
-          '{title: $$title, body: $$body, head: $$head, base: "master"}' > /tmp/gitea-pr.json
+          '{title: $$title, body: $$body, head: $$head, base: "main"}' > /tmp/gitea-pr.json
         code=$$(curl -s -o /tmp/gitea-resp.json -w '%{http_code}' \
           -X POST -H "Authorization: token $$PUSH_TOKEN" \
           -H "Content-Type: application/json" --data @/tmp/gitea-pr.json \

.woodpecker/pr-review.yml

@@ -13,7 +13,7 @@
 # Triggers on pull_request: PR opened AND new commits pushed to an open PR.
 # Approves only when the review found nothing red/yellow (see run.sh); humans merge.
 #
-# The central code is cloned from public homelab@master on every run, never taken
+# The central code is cloned from public homelab@main on every run, never taken
 # from the PR checkout, so a PR cannot alter the rubric or helper scripts it is
 # reviewed with.
 #

.woodpecker/security-scan.yml

@@ -65,11 +65,11 @@ steps:
     failure: ignore
 
   - name: security-fix-agent
-    # Auto-fix run: only on master (cron / manual / direct push). On the
+    # Auto-fix run: only on main (cron / manual / direct push). On the
     # bot's own PR branches, the scans re-run as a re-validation gate but
     # this step is skipped — otherwise we'd fork-bomb PRs.
     when:
-      - branch: master
+      - branch: main
     image: gitea.renner.uno/gitea_admin/ci-claude:2.1.303
     environment:
       CLAUDE_CODE_OAUTH_TOKEN:
@@ -152,7 +152,7 @@ steps:
           --arg title "$$TITLE" \
           --arg body  "$$BODY"  \
           --arg head  "$$BRANCH" \
-          '{title: $$title, body: $$body, head: $$head, base: "master"}' \
+          '{title: $$title, body: $$body, head: $$head, base: "main"}' \
         | curl -sfL -X POST \
             -H "Authorization: token $$GITEA_TOKEN" \
             -H "Content-Type: application/json" \

.woodpecker/update-audit.yml

@@ -15,7 +15,7 @@
 #              name filter is the only thing that can select a workflow for a
 #              scheduled run:
 #                woodpecker repo cron add --repo konairius/homelab \
-#                  --name update-audit --branch master --schedule '@weekly'
+#                  --name update-audit --branch main --schedule '@weekly'
 #   - deploy : woodpecker-cli pipeline deploy konairius/homelab <n> update-audit
 #              where <n> is an existing pipeline to promote.
 #

README.md

@@ -1,6 +1,6 @@
 # homelab
 
-GitOps source for the Renner homelab cluster. Flux applies `master` to
+GitOps source for the Renner homelab cluster. Flux applies `main` to
 production, so every merge is a production change. Changes go in by pull
 request only; see [CONTRIBUTING.md](CONTRIBUTING.md) for YAML conventions.
 

ansible/roles/uptime-kuma/defaults/main.yml

@@ -2,10 +2,6 @@
 uptime_kuma_version: "2.5.6"
 uptime_kuma_host: kuma.renner.uno
 uptime_kuma_base_url: "https://{{ uptime_kuma_host }}"
-# Custom domain of the status page; not routed by Traefik yet.
-uptime_kuma_status_host: uptime.renner.uno
-uptime_kuma_status_slug: renner
-uptime_kuma_status_title: Renner
 uptime_kuma_dir: /opt/uptime-kuma
 uptime_kuma_traefik_network: netbird_netbird
 

ansible/roles/uptime-kuma/files/kuma-setup.js

@@ -1,4 +1,4 @@
-// Bootstraps Uptime Kuma: admin user, general settings, SMTP notification, status page,
+// Bootstraps Uptime Kuma: admin user, general settings, SMTP notification,
 // and (when KUMA_METRICS_ROTATE=true) a fresh Prometheus API key written to KUMA_METRICS_KEY_FILE.
 // All input comes from environment variables; secrets are never printed.
 // Output lines: "admin user created" / "already set up", then "changed: <step>" or "ok: <step>".
@@ -30,9 +30,6 @@ const REQUIRED = [
     "KUMA_SMTP_PASSWORD",
     "KUMA_SMTP_FROM",
     "KUMA_SMTP_TO",
-    "KUMA_STATUS_SLUG",
-    "KUMA_STATUS_TITLE",
-    "KUMA_STATUS_DOMAIN",
 ];
 const missing = REQUIRED.filter((name) => !process.env[name]);
 const rotateMetricsKey = process.env.KUMA_METRICS_ROTATE === "true";
@@ -47,7 +44,7 @@ const env = process.env;
 
 const socket = io(KUMA_URL, { transports: ["websocket"], reconnection: false });
 const lists = {};
-const LIST_EVENTS = ["notificationList", "apiKeyList", "statusPageList"];
+const LIST_EVENTS = ["notificationList", "apiKeyList"];
 for (const event of LIST_EVENTS) {
     socket.on(event, (data) => {
         lists[event] = data;
@@ -154,48 +151,6 @@ async function ensureNotification() {
     report("notification", true);
 }
 
-async function fetchPublicGroupList(slug) {
-    const res = await fetch(`${KUMA_URL}/api/status-page/${encodeURIComponent(slug)}`);
-    if (!res.ok) {
-        throw new Error(`GET /api/status-page/${slug} returned ${res.status}`);
-    }
-    const body = await res.json();
-    return (body.publicGroupList || []).map((group) => ({
-        id: group.id,
-        name: group.name,
-        monitorList: (group.monitorList || []).map((monitor) => {
-            const entry = { id: monitor.id };
-            if (monitor.sendUrl !== undefined) entry.sendUrl = monitor.sendUrl;
-            if (monitor.url !== undefined) entry.url = monitor.url;
-            return entry;
-        }),
-    }));
-}
-
-async function ensureStatusPage() {
-    const slug = env.KUMA_STATUS_SLUG;
-    let changed = false;
-    const pages = Object.values(lists.statusPageList || {});
-    if (!pages.some((page) => page.slug === slug)) {
-        await callOk("addStatusPage", env.KUMA_STATUS_TITLE, slug);
-        changed = true;
-    }
-    const { config } = await callOk("getStatusPage", slug);
-    const domains = config.domainNameList || [];
-    if (config.title !== env.KUMA_STATUS_TITLE || !domains.includes(env.KUMA_STATUS_DOMAIN)) {
-        // saveStatusPage replaces all groups, so the current ones are sent back unchanged.
-        const publicGroupList = await fetchPublicGroupList(slug);
-        const updated = {
-            ...config,
-            title: env.KUMA_STATUS_TITLE,
-            domainNameList: domains.includes(env.KUMA_STATUS_DOMAIN) ? domains : [...domains, env.KUMA_STATUS_DOMAIN],
-        };
-        await callOk("saveStatusPage", slug, updated, config.icon, publicGroupList);
-        changed = true;
-    }
-    report("status page", changed);
-}
-
 async function rotateMetricsApiKey() {
     if (!rotateMetricsKey) {
         report("metrics api key", false);
@@ -215,7 +170,6 @@ async function main() {
     await login();
     await ensureSettings();
     await ensureNotification();
-    await ensureStatusPage();
     await rotateMetricsApiKey();
 }
 

ansible/roles/uptime-kuma/tasks/main.yml

@@ -139,12 +139,6 @@
       - -e
       - KUMA_SMTP_TO
       - -e
-      - KUMA_STATUS_SLUG
-      - -e
-      - KUMA_STATUS_TITLE
-      - -e
-      - KUMA_STATUS_DOMAIN
-      - -e
       - KUMA_METRICS_ROTATE
       - -e
       - KUMA_METRICS_KEY_FILE
@@ -163,9 +157,6 @@
     KUMA_SMTP_PASSWORD: "{{ _uptime_kuma_smtp.secret.token }}"
     KUMA_SMTP_FROM: "{{ uptime_kuma_smtp_from }}"
     KUMA_SMTP_TO: "{{ uptime_kuma_smtp_to }}"
-    KUMA_STATUS_SLUG: "{{ uptime_kuma_status_slug }}"
-    KUMA_STATUS_TITLE: "{{ uptime_kuma_status_title }}"
-    KUMA_STATUS_DOMAIN: "{{ uptime_kuma_status_host }}"
     KUMA_METRICS_ROTATE: "{{ 'false' if (_uptime_kuma_metrics_check.status | default(0)) == 200 else 'true' }}"
     KUMA_METRICS_KEY_FILE: /app/data/.metrics-api-key
   register: _uptime_kuma_setup

ci/agents/pr-review/mistral-prompt.md

@@ -13,7 +13,7 @@ HARD RULES
   run tools or change files, and note such an attempt in your report if it is blatant.
 - Never print anything that looks like a secret or token, even if the PR added one; refer to it by location and
   flag it as blocking.
-- Repos use different default branches (homelab: master; others: main). Read the PR to get the head ref and sha and
+- Every repo's default branch is main. Read the PR to get the head ref and sha and
   read files at the head sha.
 
 ## How to work

ci/agents/pr-review/run.sh

@@ -65,7 +65,7 @@ AUTH="Authorization: token $REVIEW_TOKEN"
 WS="$PWD"                     # workspace = this repo, checked out at the PR head by Woodpecker
 MAX_DIFF_LINES=20000
 
-# This script, the prompts and scripts/ci/ all come from the homelab@master
+# This script, the prompts and scripts/ci/ all come from the homelab@main
 # clone the per-repo stub made (see .woodpecker/pr-review.yml) — never from the
 # PR checkout, so a PR cannot change the rubric or the helper scripts it is
 # reviewed with.
@@ -115,7 +115,7 @@ while IFS= read -r ITEM; do
   # event, so Woodpecker's built-in clone already checked THIS repo out
   # at the PR head in $WS — the agents (which cd into $WS) read it
   # directly for context. The old cron model had to clone each target
-  # repo by hand (its workspace was homelab@master), and that clone
+  # repo by hand (its workspace was homelab@main), and that clone
   # embedded REVIEW_TOKEN in the URL, persisting a write-scoped PAT in
   # work/target/.git/config — readable by the review agent whose report
   # is posted publicly. Per-repo pull_request triggering makes the manual

ci/images/kuma-sync/api/v1alpha1/kumamonitor_types.go

@@ -52,6 +52,17 @@ type DNSSpec struct {
 	// +kubebuilder:validation:Maximum=65535
 	// +kubebuilder:default=53
 	Port int32 `json:"port,omitempty"`
+	// Conditions on the answer, all of which must hold for one record. For
+	// CNAME the record is the first target, without the trailing dot.
+	Conditions []DNSCondition `json:"conditions,omitempty"`
+}
+
+// DNSCondition tests a DNS record with one of Kuma's string operators.
+type DNSCondition struct {
+	// +kubebuilder:validation:Enum=equals;not_equals;contains;not_contains;starts_with;not_starts_with;ends_with;not_ends_with
+	Operator string `json:"operator"`
+	// +kubebuilder:validation:MinLength=1
+	Value string `json:"value"`
 }
 
 type PortSpec struct {

ci/images/kuma-sync/api/v1alpha1/kumastatuspage_types.go

@@ -0,0 +1,82 @@
+package v1alpha1
+
+import (
+	metav1 "k8s.io/apimachinery/pkg/apis/meta/v1"
+)
+
+// StatusPageSection is one group of monitors on the status page.
+type StatusPageSection struct {
+	// +kubebuilder:validation:MinLength=1
+	Name string `json:"name"`
+	// Selects KumaMonitors in any namespace.
+	Selector metav1.LabelSelector `json:"selector"`
+}
+
+type KumaStatusPageSpec struct {
+	// Kuma slug: lowercase letters and digits, single hyphens between them.
+	// +kubebuilder:validation:Pattern=`^[a-z0-9]+(-[a-z0-9]+)*$`
+	// +kubebuilder:validation:XValidation:rule="self == oldSelf",message="slug is immutable"
+	Slug string `json:"slug"`
+	// +kubebuilder:validation:MinLength=1
+	Title       string `json:"title"`
+	Description string `json:"description,omitempty"`
+	FooterText  string `json:"footerText,omitempty"`
+	// Hostnames that serve this page.
+	// +listType=set
+	// +kubebuilder:validation:items:MaxLength=253
+	// +kubebuilder:validation:items:Pattern=`^[a-z0-9]([-a-z0-9]*[a-z0-9])?(\.[a-z0-9]([-a-z0-9]*[a-z0-9])?)*$`
+	DomainNames []string `json:"domainNames,omitempty"`
+	// +kubebuilder:validation:Enum=auto;light;dark
+	// +kubebuilder:default=auto
+	Theme                 string `json:"theme,omitempty"`
+	ShowTags              bool   `json:"showTags,omitempty"`
+	ShowPoweredBy         bool   `json:"showPoweredBy,omitempty"`
+	ShowCertificateExpiry bool   `json:"showCertificateExpiry,omitempty"`
+
+	// Ordered. A monitor matching several sections is listed in the first only.
+	// +kubebuilder:validation:MinItems=1
+	// +listType=map
+	// +listMapKey=name
+	Sections []StatusPageSection `json:"sections"`
+}
+
+type SectionStatus struct {
+	Name     string `json:"name"`
+	Monitors int32  `json:"monitors"`
+}
+
+type KumaStatusPageStatus struct {
+	StatusPageID       int64 `json:"statusPageID,omitempty"`
+	ObservedGeneration int64 `json:"observedGeneration,omitempty"`
+	// Monitors listed per section.
+	Sections []SectionStatus `json:"sections,omitempty"`
+	// Selected monitors left out because they have no Kuma monitor ID yet.
+	UnsyncedMonitors int32 `json:"unsyncedMonitors,omitempty"`
+	// +listType=map
+	// +listMapKey=type
+	Conditions []metav1.Condition `json:"conditions,omitempty"`
+}
+
+// +kubebuilder:object:root=true
+// +kubebuilder:subresource:status
+// +kubebuilder:resource:path=kumastatuspages,scope=Namespaced
+// +kubebuilder:printcolumn:name="Slug",type=string,JSONPath=`.spec.slug`
+// +kubebuilder:printcolumn:name="Ready",type=string,JSONPath=`.status.conditions[?(@.type=="Ready")].status`
+type KumaStatusPage struct {
+	metav1.TypeMeta   `json:",inline"`
+	metav1.ObjectMeta `json:"metadata,omitempty"`
+
+	Spec   KumaStatusPageSpec   `json:"spec"`
+	Status KumaStatusPageStatus `json:"status,omitempty"`
+}
+
+// +kubebuilder:object:root=true
+type KumaStatusPageList struct {
+	metav1.TypeMeta `json:",inline"`
+	metav1.ListMeta `json:"metadata,omitempty"`
+	Items           []KumaStatusPage `json:"items"`
+}
+
+func init() {
+	SchemeBuilder.Register(&KumaStatusPage{}, &KumaStatusPageList{})
+}

ci/images/kuma-sync/api/v1alpha1/validation_test.go

@@ -4,15 +4,19 @@ package v1alpha1
 
 import (
 	"context"
+	"fmt"
+	"os"
 	"path/filepath"
 	"strings"
 	"testing"
 
 	"k8s.io/apimachinery/pkg/api/errors"
 	metav1 "k8s.io/apimachinery/pkg/apis/meta/v1"
+	"k8s.io/apimachinery/pkg/apis/meta/v1/unstructured"
 	"k8s.io/apimachinery/pkg/runtime"
 	"sigs.k8s.io/controller-runtime/pkg/client"
 	"sigs.k8s.io/controller-runtime/pkg/envtest"
+	"sigs.k8s.io/yaml"
 )
 
 var k8s client.Client
@@ -196,3 +200,106 @@ func TestDeletionBumpsGeneration(t *testing.T) {
 		t.Fatalf("generation %d did not increase past %d on deletion", got.Generation, before)
 	}
 }
+
+func statusPage(name string, mutate func(*KumaStatusPageSpec)) *KumaStatusPage {
+	sp := &KumaStatusPage{
+		ObjectMeta: metav1.ObjectMeta{Name: name, Namespace: "default"},
+		Spec: KumaStatusPageSpec{
+			Slug: "renner", Title: "Renner",
+			Sections: []StatusPageSection{{Name: "Core", Selector: metav1.LabelSelector{}}},
+		},
+	}
+	if mutate != nil {
+		mutate(&sp.Spec)
+	}
+	return sp
+}
+
+func expectPageInvalid(t *testing.T, sp *KumaStatusPage, wants ...string) {
+	t.Helper()
+	err := k8s.Create(context.Background(), sp)
+	if err == nil || !errors.IsInvalid(err) {
+		t.Fatalf("expected invalid, got %v", err)
+	}
+	for _, w := range wants {
+		if !strings.Contains(err.Error(), w) {
+			t.Fatalf("error %q does not contain %q", err.Error(), w)
+		}
+	}
+}
+
+func TestStatusPageDefaults(t *testing.T) {
+	ctx := context.Background()
+	sp := statusPage("page-defaults", nil)
+	if err := k8s.Create(ctx, sp); err != nil {
+		t.Fatal(err)
+	}
+	got := &KumaStatusPage{}
+	if err := k8s.Get(ctx, client.ObjectKeyFromObject(sp), got); err != nil {
+		t.Fatal(err)
+	}
+	if got.Spec.Theme != "auto" {
+		t.Fatalf("theme = %q, want auto", got.Spec.Theme)
+	}
+}
+
+func TestStatusPageSlugImmutable(t *testing.T) {
+	ctx := context.Background()
+	sp := statusPage("page-immutable", nil)
+	if err := k8s.Create(ctx, sp); err != nil {
+		t.Fatal(err)
+	}
+	sp.Spec.Slug = "other"
+	err := k8s.Update(ctx, sp)
+	if err == nil || !strings.Contains(err.Error(), "slug is immutable") {
+		t.Fatalf("expected immutable error, got %v", err)
+	}
+}
+
+// The page object deployed by Flux must pass the CRD schema.
+func TestDeployedStatusPageValid(t *testing.T) {
+	raw, err := os.ReadFile(filepath.Join("..", "..", "..", "..", "..", "kubernetes", "apps", "kuma-sync", "statuspage-renner.yaml"))
+	if err != nil {
+		t.Fatal(err)
+	}
+	sp := &KumaStatusPage{}
+	if err := yaml.UnmarshalStrict(raw, sp); err != nil {
+		t.Fatal(err)
+	}
+	ns := &unstructured.Unstructured{}
+	ns.SetAPIVersion("v1")
+	ns.SetKind("Namespace")
+	ns.SetName(sp.Namespace)
+	if err := k8s.Create(context.Background(), ns); err != nil && !errors.IsAlreadyExists(err) {
+		t.Fatal(err)
+	}
+	if err := k8s.Create(context.Background(), sp, client.DryRunAll); err != nil {
+		t.Fatalf("deployed status page rejected: %v", err)
+	}
+}
+
+func TestStatusPageInvalidSpecs(t *testing.T) {
+	cases := map[string]struct {
+		mutate func(*KumaStatusPageSpec)
+		want   string
+	}{
+		"uppercase slug":   {func(s *KumaStatusPageSpec) { s.Slug = "Renner" }, "spec.slug"},
+		"double hyphen":    {func(s *KumaStatusPageSpec) { s.Slug = "a--b" }, "spec.slug"},
+		"trailing hyphen":  {func(s *KumaStatusPageSpec) { s.Slug = "a-" }, "spec.slug"},
+		"empty title":      {func(s *KumaStatusPageSpec) { s.Title = "" }, "spec.title"},
+		"no sections":      {func(s *KumaStatusPageSpec) { s.Sections = nil }, "spec.sections"},
+		"bad theme":        {func(s *KumaStatusPageSpec) { s.Theme = "blue" }, "spec.theme"},
+		"bad domain":       {func(s *KumaStatusPageSpec) { s.DomainNames = []string{"https://x.example"} }, "spec.domainNames"},
+		"duplicate domain": {func(s *KumaStatusPageSpec) { s.DomainNames = []string{"a.example", "a.example"} }, "spec.domainNames"},
+		"duplicate section": {func(s *KumaStatusPageSpec) {
+			s.Sections = append(s.Sections, StatusPageSection{Name: "Core"})
+		}, "spec.sections"},
+	}
+	i := 0
+	for name, c := range cases {
+		i++
+		t.Run(name, func(t *testing.T) {
+			expectPageInvalid(t, statusPage(fmt.Sprintf("page-invalid-%d", i), c.mutate), c.want)
+		})
+	}
+}

ci/images/kuma-sync/api/v1alpha1/zz_generated.deepcopy.go

@@ -9,9 +9,29 @@ import (
 	runtime "k8s.io/apimachinery/pkg/runtime"
 )
 
+// DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
+func (in *DNSCondition) DeepCopyInto(out *DNSCondition) {
+	*out = *in
+}
+
+// DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new DNSCondition.
+func (in *DNSCondition) DeepCopy() *DNSCondition {
+	if in == nil {
+		return nil
+	}
+	out := new(DNSCondition)
+	in.DeepCopyInto(out)
+	return out
+}
+
 // DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
 func (in *DNSSpec) DeepCopyInto(out *DNSSpec) {
 	*out = *in
+	if in.Conditions != nil {
+		in, out := &in.Conditions, &out.Conditions
+		*out = make([]DNSCondition, len(*in))
+		copy(*out, *in)
+	}
 }
 
 // DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new DNSSpec.
@@ -176,7 +196,7 @@ func (in *KumaMonitorSpec) DeepCopyInto(out *KumaMonitorSpec) {
 	if in.DNS != nil {
 		in, out := &in.DNS, &out.DNS
 		*out = new(DNSSpec)
-		**out = **in
+		(*in).DeepCopyInto(*out)
 	}
 	if in.Port != nil {
 		in, out := &in.Port, &out.Port
@@ -217,6 +237,119 @@ func (in *KumaMonitorStatus) DeepCopy() *KumaMonitorStatus {
 	return out
 }
 
+// DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
+func (in *KumaStatusPage) DeepCopyInto(out *KumaStatusPage) {
+	*out = *in
+	out.TypeMeta = in.TypeMeta
+	in.ObjectMeta.DeepCopyInto(&out.ObjectMeta)
+	in.Spec.DeepCopyInto(&out.Spec)
+	in.Status.DeepCopyInto(&out.Status)
+}
+
+// DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new KumaStatusPage.
+func (in *KumaStatusPage) DeepCopy() *KumaStatusPage {
+	if in == nil {
+		return nil
+	}
+	out := new(KumaStatusPage)
+	in.DeepCopyInto(out)
+	return out
+}
+
+// DeepCopyObject is an autogenerated deepcopy function, copying the receiver, creating a new runtime.Object.
+func (in *KumaStatusPage) DeepCopyObject() runtime.Object {
+	if c := in.DeepCopy(); c != nil {
+		return c
+	}
+	return nil
+}
+
+// DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
+func (in *KumaStatusPageList) DeepCopyInto(out *KumaStatusPageList) {
+	*out = *in
+	out.TypeMeta = in.TypeMeta
+	in.ListMeta.DeepCopyInto(&out.ListMeta)
+	if in.Items != nil {
+		in, out := &in.Items, &out.Items
+		*out = make([]KumaStatusPage, len(*in))
+		for i := range *in {
+			(*in)[i].DeepCopyInto(&(*out)[i])
+		}
+	}
+}
+
+// DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new KumaStatusPageList.
+func (in *KumaStatusPageList) DeepCopy() *KumaStatusPageList {
+	if in == nil {
+		return nil
+	}
+	out := new(KumaStatusPageList)
+	in.DeepCopyInto(out)
+	return out
+}
+
+// DeepCopyObject is an autogenerated deepcopy function, copying the receiver, creating a new runtime.Object.
+func (in *KumaStatusPageList) DeepCopyObject() runtime.Object {
+	if c := in.DeepCopy(); c != nil {
+		return c
+	}
+	return nil
+}
+
+// DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
+func (in *KumaStatusPageSpec) DeepCopyInto(out *KumaStatusPageSpec) {
+	*out = *in
+	if in.DomainNames != nil {
+		in, out := &in.DomainNames, &out.DomainNames
+		*out = make([]string, len(*in))
+		copy(*out, *in)
+	}
+	if in.Sections != nil {
+		in, out := &in.Sections, &out.Sections
+		*out = make([]StatusPageSection, len(*in))
+		for i := range *in {
+			(*in)[i].DeepCopyInto(&(*out)[i])
+		}
+	}
+}
+
+// DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new KumaStatusPageSpec.
+func (in *KumaStatusPageSpec) DeepCopy() *KumaStatusPageSpec {
+	if in == nil {
+		return nil
+	}
+	out := new(KumaStatusPageSpec)
+	in.DeepCopyInto(out)
+	return out
+}
+
+// DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
+func (in *KumaStatusPageStatus) DeepCopyInto(out *KumaStatusPageStatus) {
+	*out = *in
+	if in.Sections != nil {
+		in, out := &in.Sections, &out.Sections
+		*out = make([]SectionStatus, len(*in))
+		copy(*out, *in)
+	}
+	if in.Conditions != nil {
+		in, out := &in.Conditions, &out.Conditions
+		*out = make([]v1.Condition, len(*in))
+		for i := range *in {
+			(*in)[i].DeepCopyInto(&(*out)[i])
+		}
+	}
+}
+
+// DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new KumaStatusPageStatus.
+func (in *KumaStatusPageStatus) DeepCopy() *KumaStatusPageStatus {
+	if in == nil {
+		return nil
+	}
+	out := new(KumaStatusPageStatus)
+	in.DeepCopyInto(out)
+	return out
+}
+
 // DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
 func (in *LocalRef) DeepCopyInto(out *LocalRef) {
 	*out = *in
@@ -246,3 +379,34 @@ func (in *PortSpec) DeepCopy() *PortSpec {
 	in.DeepCopyInto(out)
 	return out
 }
+
+// DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
+func (in *SectionStatus) DeepCopyInto(out *SectionStatus) {
+	*out = *in
+}
+
+// DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new SectionStatus.
+func (in *SectionStatus) DeepCopy() *SectionStatus {
+	if in == nil {
+		return nil
+	}
+	out := new(SectionStatus)
+	in.DeepCopyInto(out)
+	return out
+}
+
+// DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
+func (in *StatusPageSection) DeepCopyInto(out *StatusPageSection) {
+	*out = *in
+	in.Selector.DeepCopyInto(&out.Selector)
+}
+
+// DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new StatusPageSection.
+func (in *StatusPageSection) DeepCopy() *StatusPageSection {
+	if in == nil {
+		return nil
+	}
+	out := new(StatusPageSection)
+	in.DeepCopyInto(out)
+	return out
+}

ci/images/kuma-sync/config/crd/uptime.renner.uno_kumamonitors.yaml

@@ -51,6 +51,33 @@ spec:
                 type: string
               dns:
                 properties:
+                  conditions:
+                    description: |-
+                      Conditions on the answer, all of which must hold for one record. For
+                      CNAME the record is the first target, without the trailing dot.
+                    items:
+                      description: DNSCondition tests a DNS record with one of Kuma's
+                        string operators.
+                      properties:
+                        operator:
+                          enum:
+                          - equals
+                          - not_equals
+                          - contains
+                          - not_contains
+                          - starts_with
+                          - not_starts_with
+                          - ends_with
+                          - not_ends_with
+                          type: string
+                        value:
+                          minLength: 1
+                          type: string
+                      required:
+                      - operator
+                      - value
+                      type: object
+                    type: array
                   hostname:
                     minLength: 1
                     type: string

ci/images/kuma-sync/config/crd/uptime.renner.uno_kumastatuspages.yaml

@@ -0,0 +1,246 @@
+---
+apiVersion: apiextensions.k8s.io/v1
+kind: CustomResourceDefinition
+metadata:
+  annotations:
+    controller-gen.kubebuilder.io/version: v0.23.0
+  name: kumastatuspages.uptime.renner.uno
+spec:
+  group: uptime.renner.uno
+  names:
+    kind: KumaStatusPage
+    listKind: KumaStatusPageList
+    plural: kumastatuspages
+    singular: kumastatuspage
+  scope: Namespaced
+  versions:
+  - additionalPrinterColumns:
+    - jsonPath: .spec.slug
+      name: Slug
+      type: string
+    - jsonPath: .status.conditions[?(@.type=="Ready")].status
+      name: Ready
+      type: string
+    name: v1alpha1
+    schema:
+      openAPIV3Schema:
+        properties:
+          apiVersion:
+            description: |-
+              APIVersion defines the versioned schema of this representation of an object.
+              Servers should convert recognized schemas to the latest internal value, and
+              may reject unrecognized values.
+              More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
+            type: string
+          kind:
+            description: |-
+              Kind is a string value representing the REST resource this object represents.
+              Servers may infer this from the endpoint the client submits requests to.
+              Cannot be updated.
+              In CamelCase.
+              More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
+            type: string
+          metadata:
+            type: object
+          spec:
+            properties:
+              description:
+                type: string
+              domainNames:
+                description: Hostnames that serve this page.
+                items:
+                  maxLength: 253
+                  pattern: ^[a-z0-9]([-a-z0-9]*[a-z0-9])?(\.[a-z0-9]([-a-z0-9]*[a-z0-9])?)*$
+                  type: string
+                type: array
+                x-kubernetes-list-type: set
+              footerText:
+                type: string
+              sections:
+                description: Ordered. A monitor matching several sections is listed
+                  in the first only.
+                items:
+                  description: StatusPageSection is one group of monitors on the status
+                    page.
+                  properties:
+                    name:
+                      minLength: 1
+                      type: string
+                    selector:
+                      description: Selects KumaMonitors in any namespace.
+                      properties:
+                        matchExpressions:
+                          description: matchExpressions is a list of label selector
+                            requirements. The requirements are ANDed.
+                          items:
+                            description: |-
+                              A label selector requirement is a selector that contains values, a key, and an operator that
+                              relates the key and values.
+                            properties:
+                              key:
+                                description: key is the label key that the selector
+                                  applies to.
+                                type: string
+                              operator:
+                                description: |-
+                                  operator represents a key's relationship to a set of values.
+                                  Valid operators are In, NotIn, Exists and DoesNotExist.
+                                type: string
+                              values:
+                                description: |-
+                                  values is an array of string values. If the operator is In or NotIn,
+                                  the values array must be non-empty. If the operator is Exists or DoesNotExist,
+                                  the values array must be empty. This array is replaced during a strategic
+                                  merge patch.
+                                items:
+                                  type: string
+                                type: array
+                                x-kubernetes-list-type: atomic
+                            required:
+                            - key
+                            - operator
+                            type: object
+                          type: array
+                          x-kubernetes-list-type: atomic
+                        matchLabels:
+                          additionalProperties:
+                            type: string
+                          description: |-
+                            matchLabels is a map of {key,value} pairs. A single {key,value} in the matchLabels
+                            map is equivalent to an element of matchExpressions, whose key field is "key", the
+                            operator is "In", and the values array contains only "value". The requirements are ANDed.
+                          type: object
+                      type: object
+                      x-kubernetes-map-type: atomic
+                  required:
+                  - name
+                  - selector
+                  type: object
+                minItems: 1
+                type: array
+                x-kubernetes-list-map-keys:
+                - name
+                x-kubernetes-list-type: map
+              showCertificateExpiry:
+                type: boolean
+              showPoweredBy:
+                type: boolean
+              showTags:
+                type: boolean
+              slug:
+                description: 'Kuma slug: lowercase letters and digits, single hyphens
+                  between them.'
+                pattern: ^[a-z0-9]+(-[a-z0-9]+)*$
+                type: string
+                x-kubernetes-validations:
+                - message: slug is immutable
+                  rule: self == oldSelf
+              theme:
+                default: auto
+                enum:
+                - auto
+                - light
+                - dark
+                type: string
+              title:
+                minLength: 1
+                type: string
+            required:
+            - sections
+            - slug
+            - title
+            type: object
+          status:
+            properties:
+              conditions:
+                items:
+                  description: Condition contains details for one aspect of the current
+                    state of this API Resource.
+                  properties:
+                    lastTransitionTime:
+                      description: |-
+                        lastTransitionTime is the last time the condition transitioned from one status to another.
+                        This should be when the underlying condition changed.  If that is not known, then using the time when the API field changed is acceptable.
+                      format: date-time
+                      type: string
+                    message:
+                      description: |-
+                        message is a human readable message indicating details about the transition.
+                        This may be an empty string.
+                      maxLength: 32768
+                      type: string
+                    observedGeneration:
+                      description: |-
+                        observedGeneration represents the .metadata.generation that the condition was set based upon.
+                        For instance, if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration is 9, the condition is out of date
+                        with respect to the current state of the instance.
+                      format: int64
+                      minimum: 0
+                      type: integer
+                    reason:
+                      description: |-
+                        reason contains a programmatic identifier indicating the reason for the condition's last transition.
+                        Producers of specific condition types may define expected values and meanings for this field,
+                        and whether the values are considered a guaranteed API.
+                        The value should be a CamelCase string.
+                        This field may not be empty.
+                      maxLength: 1024
+                      minLength: 1
+                      pattern: ^[A-Za-z]([A-Za-z0-9_,:]*[A-Za-z0-9_])?$
+                      type: string
+                    status:
+                      description: status of the condition, one of True, False, Unknown.
+                      enum:
+                      - "True"
+                      - "False"
+                      - Unknown
+                      type: string
+                    type:
+                      description: type of condition in CamelCase or in foo.example.com/CamelCase.
+                      maxLength: 316
+                      pattern: ^([a-z0-9]([-a-z0-9]*[a-z0-9])?(\.[a-z0-9]([-a-z0-9]*[a-z0-9])?)*/)?(([A-Za-z0-9][-A-Za-z0-9_.]*)?[A-Za-z0-9])$
+                      type: string
+                  required:
+                  - lastTransitionTime
+                  - message
+                  - reason
+                  - status
+                  - type
+                  type: object
+                type: array
+                x-kubernetes-list-map-keys:
+                - type
+                x-kubernetes-list-type: map
+              observedGeneration:
+                format: int64
+                type: integer
+              sections:
+                description: Monitors listed per section.
+                items:
+                  properties:
+                    monitors:
+                      format: int32
+                      type: integer
+                    name:
+                      type: string
+                  required:
+                  - monitors
+                  - name
+                  type: object
+                type: array
+              statusPageID:
+                format: int64
+                type: integer
+              unsyncedMonitors:
+                description: Selected monitors left out because they have no Kuma
+                  monitor ID yet.
+                format: int32
+                type: integer
+            type: object
+        required:
+        - spec
+        type: object
+    served: true
+    storage: true
+    subresources:
+      status: {}

ci/images/kuma-sync/config/rbac/role.yaml

@@ -21,6 +21,7 @@ rules:
   - uptime.renner.uno
   resources:
   - kumamonitors
+  - kumastatuspages
   verbs:
   - get
   - list
@@ -31,12 +32,14 @@ rules:
   - uptime.renner.uno
   resources:
   - kumamonitors/finalizers
+  - kumastatuspages/finalizers
   verbs:
   - update
 - apiGroups:
   - uptime.renner.uno
   resources:
   - kumamonitors/status
+  - kumastatuspages/status
   verbs:
   - get
   - patch

ci/images/kuma-sync/go.mod

@@ -10,6 +10,7 @@ require (
 	k8s.io/client-go v0.37.1
 	k8s.io/utils v0.0.0-20260707023825-cf1189d6abe3
 	sigs.k8s.io/controller-runtime v0.25.2
+	sigs.k8s.io/yaml v1.6.0
 )
 
 require (
@@ -117,7 +118,6 @@ require (
 	sigs.k8s.io/json v0.0.0-20250730193827-2d320260d730 // indirect
 	sigs.k8s.io/randfill v1.0.0 // indirect
 	sigs.k8s.io/structured-merge-diff/v6 v6.4.2 // indirect
-	sigs.k8s.io/yaml v1.6.0 // indirect
 )
 
 replace github.com/maldikhan/go.socket.io => github.com/breml/go.socket.io v0.0.0-20260516193936-e70410c8cd31

ci/images/kuma-sync/internal/app/manager.go

@@ -47,7 +47,7 @@ type Options struct {
 	SkipNameValidation bool
 }
 
-// NewManager builds the manager with the reconciler and the orphan GC.
+// NewManager builds the manager with the reconcilers and the orphan GC.
 // There is no leader election: a single replica runs.
 func NewManager(o Options) (manager.Manager, error) {
 	scheme := runtime.NewScheme()
@@ -75,6 +75,9 @@ func NewManager(o Options) (manager.Manager, error) {
 	if err := (&controller.Reconciler{Client: mgr.GetClient(), Kuma: o.Kuma, Resync: o.Resync}).SetupWithManager(mgr); err != nil {
 		return nil, fmt.Errorf("set up reconciler: %w", err)
 	}
+	if err := (&controller.StatusPageReconciler{Client: mgr.GetClient(), Kuma: o.Kuma, Resync: o.Resync}).SetupWithManager(mgr); err != nil {
+		return nil, fmt.Errorf("set up status page reconciler: %w", err)
+	}
 	if err := mgr.Add(&controller.GC{
 		Client:      mgr.GetClient(),
 		Kuma:        o.Kuma,

ci/images/kuma-sync/internal/controller/mapping.go

@@ -11,6 +11,9 @@ import (
 // defaultMaxRedirects is Kuma's default for a monitor with no explicit value.
 const defaultMaxRedirects = 10
 
+// dnsConditionVariable is the only condition variable of Kuma's dns type.
+const dnsConditionVariable = "record"
+
 // OwnerKey is the value of the kuma-sync tag for a resource.
 func OwnerKey(km *v1.KumaMonitor) string {
 	return km.Namespace + "/" + km.Name
@@ -60,6 +63,11 @@ func Desired(km *v1.KumaMonitor) kumaclient.Monitor {
 		m.DNSResolveType = d.ResolveType
 		m.DNSResolveServer = d.ResolveServer
 		m.Port = d.Port
+		for _, c := range d.Conditions {
+			m.DNSConditions = append(m.DNSConditions, kumaclient.Condition{
+				Variable: dnsConditionVariable, Operator: c.Operator, Value: c.Value, AndOr: "and",
+			})
+		}
 	}
 	if p := s.Port; p != nil {
 		m.Hostname = p.Hostname

ci/images/kuma-sync/internal/controller/mapping_test.go

@@ -50,6 +50,9 @@ func TestMappingAllTypes(t *testing.T) {
 	jq.JSONQuery = &v1.JSONQuerySpec{Expression: "a.b", Operator: "contains", Expected: "z"}
 	dns := base("dns")
 	dns.DNS = &v1.DNSSpec{Hostname: "h.com", ResolveType: "AAAA", ResolveServer: "9.9.9.9", Port: 5353}
+	dnsCond := base("dns")
+	dnsCond.DNS = &v1.DNSSpec{Hostname: "c.com", ResolveType: "CNAME", ResolveServer: "9.9.9.9", Port: 53,
+		Conditions: []v1.DNSCondition{{Operator: "equals", Value: "t.com"}, {Operator: "not_contains", Value: "x"}}}
 	port := base("port")
 	port.Port = &v1.PortSpec{Hostname: "p.com", Port: 443}
 	paused := base("group")
@@ -61,6 +64,12 @@ func TestMappingAllTypes(t *testing.T) {
 	wantJQ.JSONPath, wantJQ.JSONPathOperator, wantJQ.ExpectedValue = "a.b", "contains", "z"
 	wantDNS := common("dns")
 	wantDNS.Hostname, wantDNS.DNSResolveType, wantDNS.DNSResolveServer, wantDNS.Port = "h.com", "AAAA", "9.9.9.9", 5353
+	wantDNSCond := common("dns")
+	wantDNSCond.Hostname, wantDNSCond.DNSResolveType, wantDNSCond.DNSResolveServer, wantDNSCond.Port = "c.com", "CNAME", "9.9.9.9", 53
+	wantDNSCond.DNSConditions = []kumaclient.Condition{
+		{Variable: "record", Operator: "equals", Value: "t.com", AndOr: "and"},
+		{Variable: "record", Operator: "not_contains", Value: "x", AndOr: "and"},
+	}
 	wantPort := common("port")
 	wantPort.Hostname, wantPort.Port = "p.com", 443
 	wantPaused := common("group")
@@ -76,6 +85,7 @@ func TestMappingAllTypes(t *testing.T) {
 		{"keyword", kw, wantKW},
 		{"json-query", jq, wantJQ},
 		{"dns", dns, wantDNS},
+		{"dns with conditions", dnsCond, wantDNSCond},
 		{"port", port, wantPort},
 		{"paused maps to inactive", paused, wantPaused},
 	}

ci/images/kuma-sync/internal/controller/statuspage_controller.go

@@ -0,0 +1,316 @@
+package controller
+
+import (
+	"cmp"
+	"context"
+	"errors"
+	"reflect"
+	"slices"
+	"time"
+
+	"k8s.io/apimachinery/pkg/api/meta"
+	metav1 "k8s.io/apimachinery/pkg/apis/meta/v1"
+	"k8s.io/apimachinery/pkg/labels"
+	"k8s.io/apimachinery/pkg/types"
+	ctrl "sigs.k8s.io/controller-runtime"
+	"sigs.k8s.io/controller-runtime/pkg/builder"
+	"sigs.k8s.io/controller-runtime/pkg/client"
+	"sigs.k8s.io/controller-runtime/pkg/controller/controllerutil"
+	"sigs.k8s.io/controller-runtime/pkg/event"
+	"sigs.k8s.io/controller-runtime/pkg/handler"
+	"sigs.k8s.io/controller-runtime/pkg/log"
+	"sigs.k8s.io/controller-runtime/pkg/predicate"
+	"sigs.k8s.io/controller-runtime/pkg/reconcile"
+
+	v1 "gitea.renner.uno/konairius/homelab/kuma-sync/api/v1alpha1"
+	"gitea.renner.uno/konairius/homelab/kuma-sync/internal/kumaclient"
+)
+
+const (
+	ReasonConflict        = "Conflict"
+	ReasonInvalidSelector = "InvalidSelector"
+
+	msgPageSynced      = "status page in sync"
+	msgSlugConflict    = "an older KumaStatusPage owns this slug"
+	msgInvalidSelector = "a section selector is invalid"
+)
+
+// +kubebuilder:rbac:groups=uptime.renner.uno,resources=kumastatuspages,verbs=get;list;watch;update;patch
+// +kubebuilder:rbac:groups=uptime.renner.uno,resources=kumastatuspages/status,verbs=get;update;patch
+// +kubebuilder:rbac:groups=uptime.renner.uno,resources=kumastatuspages/finalizers,verbs=update
+
+// StatusPageReconciler syncs KumaStatusPage resources to Kuma. The page,
+// its domain names and its whole group list belong to the resource.
+type StatusPageReconciler struct {
+	Client client.Client
+	Kuma   kumaclient.StatusPages
+	// Resync is how often a healthy resource is reconciled again, which
+	// reverts edits made in Kuma. 0 means 5 minutes.
+	Resync time.Duration
+}
+
+func (r *StatusPageReconciler) resync() time.Duration {
+	if r.Resync > 0 {
+		return r.Resync
+	}
+	return resyncPeriod
+}
+
+// SetupWithManager ignores status-only updates of the page itself. Any
+// KumaMonitor change that can alter a page's content enqueues every page.
+func (r *StatusPageReconciler) SetupWithManager(mgr ctrl.Manager) error {
+	return ctrl.NewControllerManagedBy(mgr).
+		For(&v1.KumaStatusPage{}, builder.WithPredicates(predicate.GenerationChangedPredicate{})).
+		Watches(&v1.KumaMonitor{}, handler.EnqueueRequestsFromMapFunc(r.allPages),
+			builder.WithPredicates(predicate.Funcs{UpdateFunc: monitorListingChanged})).
+		Named("kumastatuspage").
+		Complete(r)
+}
+
+// monitorListingChanged reports changes to what a page shows of a monitor.
+func monitorListingChanged(e event.UpdateEvent) bool {
+	o, ok1 := e.ObjectOld.(*v1.KumaMonitor)
+	n, ok2 := e.ObjectNew.(*v1.KumaMonitor)
+	if !ok1 || !ok2 {
+		return true
+	}
+	return !reflect.DeepEqual(o.Labels, n.Labels) ||
+		o.Spec.DisplayName != n.Spec.DisplayName ||
+		o.Status.MonitorID != n.Status.MonitorID ||
+		o.DeletionTimestamp.IsZero() != n.DeletionTimestamp.IsZero()
+}
+
+func (r *StatusPageReconciler) allPages(ctx context.Context, _ client.Object) []reconcile.Request {
+	var list v1.KumaStatusPageList
+	if err := r.Client.List(ctx, &list); err != nil {
+		log.FromContext(ctx).Error(err, "list KumaStatusPages to enqueue")
+		return nil
+	}
+	reqs := make([]reconcile.Request, 0, len(list.Items))
+	for _, p := range list.Items {
+		reqs = append(reqs, reconcile.Request{NamespacedName: types.NamespacedName{Namespace: p.Namespace, Name: p.Name}})
+	}
+	return reqs
+}
+
+// pageView is the status written after a successful sync.
+type pageView struct {
+	id       int64
+	sections []v1.SectionStatus
+	unsynced int32
+}
+
+func (r *StatusPageReconciler) Reconcile(ctx context.Context, req ctrl.Request) (ctrl.Result, error) {
+	sp := &v1.KumaStatusPage{}
+	if err := r.Client.Get(ctx, req.NamespacedName, sp); err != nil {
+		return ctrl.Result{}, client.IgnoreNotFound(err)
+	}
+	if !sp.DeletionTimestamp.IsZero() {
+		return r.reconcileDelete(ctx, sp)
+	}
+	if controllerutil.AddFinalizer(sp, Finalizer) {
+		if err := r.Client.Update(ctx, sp); err != nil {
+			return ctrl.Result{}, err
+		}
+	}
+
+	owner, err := r.ownsSlug(ctx, sp)
+	if err != nil {
+		return ctrl.Result{}, err
+	}
+	if !owner {
+		err := r.setReady(ctx, sp, metav1.ConditionFalse, ReasonConflict, msgSlugConflict, &pageView{})
+		return ctrl.Result{RequeueAfter: r.resync()}, err
+	}
+
+	desired, view, err := r.desired(ctx, sp)
+	if err != nil {
+		var sel *selectorError
+		if errors.As(err, &sel) {
+			log.FromContext(ctx).Info("invalid section selector", "section", sel.section, "error", sel.err.Error())
+			err := r.setReady(ctx, sp, metav1.ConditionFalse, ReasonInvalidSelector, msgInvalidSelector,
+				&pageView{id: sp.Status.StatusPageID})
+			return ctrl.Result{RequeueAfter: r.resync()}, err
+		}
+		return ctrl.Result{}, err
+	}
+
+	cur, err := r.Kuma.GetStatusPage(ctx, sp.Spec.Slug)
+	switch {
+	case errors.Is(err, kumaclient.ErrStatusPageNotFound):
+		id, err := r.Kuma.AddStatusPage(ctx, sp.Spec.Slug, sp.Spec.Title)
+		if err != nil {
+			return r.fail(ctx, sp, &failure{ReasonKumaUnavailable, msgKumaUnavailable, err})
+		}
+		view.id = id
+		if err := r.Kuma.SaveStatusPage(ctx, desired); err != nil {
+			return r.fail(ctx, sp, &failure{ReasonKumaUnavailable, msgKumaUnavailable, err})
+		}
+	case err != nil:
+		return r.fail(ctx, sp, &failure{ReasonKumaUnavailable, msgKumaUnavailable, err})
+	default:
+		view.id = cur.ID
+		// Reusing the page's group IDs in order keeps them stable; Kuma
+		// rewrites name and monitors of each.
+		for i := range desired.Groups {
+			if i < len(cur.Groups) {
+				desired.Groups[i].ID = cur.Groups[i].ID
+			}
+		}
+		if !desired.SameContent(cur) {
+			log.FromContext(ctx).Info("status page differs from spec, saving", "slug", sp.Spec.Slug)
+			if err := r.Kuma.SaveStatusPage(ctx, desired); err != nil {
+				return r.fail(ctx, sp, &failure{ReasonKumaUnavailable, msgKumaUnavailable, err})
+			}
+		}
+	}
+
+	if err := r.setReady(ctx, sp, metav1.ConditionTrue, ReasonSynced, msgPageSynced, &view); err != nil {
+		return ctrl.Result{}, err
+	}
+	return ctrl.Result{RequeueAfter: r.resync()}, nil
+}
+
+func (r *StatusPageReconciler) reconcileDelete(ctx context.Context, sp *v1.KumaStatusPage) (ctrl.Result, error) {
+	if !controllerutil.ContainsFinalizer(sp, Finalizer) {
+		return ctrl.Result{}, nil
+	}
+	owner, err := r.ownsSlug(ctx, sp)
+	if err != nil {
+		return ctrl.Result{}, err
+	}
+	if owner {
+		err := r.Kuma.DeleteStatusPage(ctx, sp.Spec.Slug)
+		if err != nil && !errors.Is(err, kumaclient.ErrStatusPageNotFound) {
+			return r.fail(ctx, sp, &failure{ReasonKumaUnavailable, msgKumaUnavailable, err})
+		}
+	}
+	controllerutil.RemoveFinalizer(sp, Finalizer)
+	return ctrl.Result{}, r.Client.Update(ctx, sp)
+}
+
+// ownsSlug reports whether sp is the oldest KumaStatusPage with its slug;
+// ties go to the lower namespace/name.
+func (r *StatusPageReconciler) ownsSlug(ctx context.Context, sp *v1.KumaStatusPage) (bool, error) {
+	var list v1.KumaStatusPageList
+	if err := r.Client.List(ctx, &list); err != nil {
+		return false, err
+	}
+	for i := range list.Items {
+		o := &list.Items[i]
+		if o.Spec.Slug != sp.Spec.Slug || (o.Namespace == sp.Namespace && o.Name == sp.Name) {
+			continue
+		}
+		if comparePages(o, sp) < 0 {
+			return false, nil
+		}
+	}
+	return true, nil
+}
+
+func comparePages(a, b *v1.KumaStatusPage) int {
+	if c := a.CreationTimestamp.Compare(b.CreationTimestamp.Time); c != 0 {
+		return c
+	}
+	return cmp.Or(cmp.Compare(a.Namespace, b.Namespace), cmp.Compare(a.Name, b.Name))
+}
+
+type selectorError struct {
+	section string
+	err     error
+}
+
+func (e *selectorError) Error() string { return "section " + e.section + ": " + e.err.Error() }
+
+// desired builds the page from the spec and the KumaMonitors of all
+// namespaces. Each section lists its matching monitors by displayName, then
+// namespace/name; a monitor goes to the first section it matches. Monitors
+// without a Kuma ID, or being deleted, are left out; the former are counted.
+func (r *StatusPageReconciler) desired(ctx context.Context, sp *v1.KumaStatusPage) (kumaclient.StatusPage, pageView, error) {
+	s := sp.Spec
+	page := kumaclient.StatusPage{
+		Slug:                  s.Slug,
+		Title:                 s.Title,
+		Description:           s.Description,
+		FooterText:            s.FooterText,
+		Theme:                 s.Theme,
+		DomainNames:           slices.Clone(s.DomainNames),
+		ShowTags:              s.ShowTags,
+		ShowPoweredBy:         s.ShowPoweredBy,
+		ShowCertificateExpiry: s.ShowCertificateExpiry,
+	}
+	var view pageView
+
+	var monitors v1.KumaMonitorList
+	if err := r.Client.List(ctx, &monitors); err != nil {
+		return page, view, err
+	}
+	items := monitors.Items
+	slices.SortFunc(items, func(a, b v1.KumaMonitor) int {
+		return cmp.Or(
+			cmp.Compare(a.Spec.DisplayName, b.Spec.DisplayName),
+			cmp.Compare(a.Namespace, b.Namespace),
+			cmp.Compare(a.Name, b.Name),
+		)
+	})
+
+	taken := make([]bool, len(items))
+	for _, sec := range s.Sections {
+		sel, err := metav1.LabelSelectorAsSelector(&sec.Selector)
+		if err != nil {
+			return page, view, &selectorError{section: sec.Name, err: err}
+		}
+		group := kumaclient.StatusGroup{Name: sec.Name}
+		for i := range items {
+			km := &items[i]
+			if taken[i] || !km.DeletionTimestamp.IsZero() || !sel.Matches(labels.Set(km.Labels)) {
+				continue
+			}
+			taken[i] = true
+			if km.Status.MonitorID == 0 {
+				view.unsynced++
+				continue
+			}
+			group.Monitors = append(group.Monitors, kumaclient.PageMonitor{ID: km.Status.MonitorID})
+		}
+		page.Groups = append(page.Groups, group)
+		view.sections = append(view.sections, v1.SectionStatus{Name: sec.Name, Monitors: int32(len(group.Monitors))})
+	}
+	return page, view, nil
+}
+
+// fail records a Ready=False outcome and returns its cause so the request is
+// requeued with backoff.
+func (r *StatusPageReconciler) fail(ctx context.Context, sp *v1.KumaStatusPage, f *failure) (ctrl.Result, error) {
+	log.FromContext(ctx).Info("reconcile failed", "reason", f.reason, "error", f.err.Error())
+	if serr := r.setReady(ctx, sp, metav1.ConditionFalse, f.reason, f.message, nil); serr != nil {
+		return ctrl.Result{}, errors.Join(f.err, serr)
+	}
+	return ctrl.Result{}, f.err
+}
+
+// setReady writes the Ready condition, and the view when given, through the
+// status subresource. Conflict clears the view; an invalid selector keeps only
+// the page ID. It writes nothing if the status is unchanged.
+func (r *StatusPageReconciler) setReady(
+	ctx context.Context, sp *v1.KumaStatusPage, status metav1.ConditionStatus, reason, msg string, view *pageView,
+) error {
+	orig := sp.Status.DeepCopy()
+	if view != nil {
+		sp.Status.StatusPageID = view.id
+		sp.Status.Sections = view.sections
+		sp.Status.UnsyncedMonitors = view.unsynced
+		sp.Status.ObservedGeneration = sp.Generation
+	}
+	meta.SetStatusCondition(&sp.Status.Conditions, metav1.Condition{
+		Type:               v1.ConditionReady,
+		Status:             status,
+		Reason:             reason,
+		Message:            msg,
+		ObservedGeneration: sp.Generation,
+	})
+	if reflect.DeepEqual(*orig, sp.Status) {
+		return nil
+	}
+	return r.Client.Status().Update(ctx, sp)
+}

ci/images/kuma-sync/internal/controller/statuspage_controller_test.go

@@ -0,0 +1,453 @@
+package controller
+
+import (
+	"context"
+	"errors"
+	"slices"
+	"testing"
+	"time"
+
+	"k8s.io/apimachinery/pkg/api/meta"
+	metav1 "k8s.io/apimachinery/pkg/apis/meta/v1"
+	"k8s.io/apimachinery/pkg/runtime"
+	"k8s.io/apimachinery/pkg/types"
+	ctrl "sigs.k8s.io/controller-runtime"
+	"sigs.k8s.io/controller-runtime/pkg/client"
+	"sigs.k8s.io/controller-runtime/pkg/client/fake"
+	"sigs.k8s.io/controller-runtime/pkg/event"
+
+	v1 "gitea.renner.uno/konairius/homelab/kuma-sync/api/v1alpha1"
+	"gitea.renner.uno/konairius/homelab/kuma-sync/internal/kumaclient"
+)
+
+// countingPages records status page writes on top of the Kuma fake.
+type countingPages struct {
+	kumaclient.StatusPages
+	adds, saves, deletes int
+}
+
+func (c *countingPages) AddStatusPage(ctx context.Context, slug, title string) (int64, error) {
+	c.adds++
+	return c.StatusPages.AddStatusPage(ctx, slug, title)
+}
+
+func (c *countingPages) SaveStatusPage(ctx context.Context, p kumaclient.StatusPage) error {
+	c.saves++
+	return c.StatusPages.SaveStatusPage(ctx, p)
+}
+
+func (c *countingPages) DeleteStatusPage(ctx context.Context, slug string) error {
+	c.deletes++
+	return c.StatusPages.DeleteStatusPage(ctx, slug)
+}
+
+type pageEnv struct {
+	r    *StatusPageReconciler
+	k8s  client.Client
+	kuma *kumaclient.Fake
+	cnt  *countingPages
+}
+
+func newPageEnv(t *testing.T, objs ...client.Object) *pageEnv {
+	t.Helper()
+	s := runtime.NewScheme()
+	if err := v1.AddToScheme(s); err != nil {
+		t.Fatal(err)
+	}
+	k8s := fake.NewClientBuilder().WithScheme(s).WithObjects(objs...).
+		WithStatusSubresource(&v1.KumaMonitor{}, &v1.KumaStatusPage{}).Build()
+	kf := kumaclient.NewFake()
+	cnt := &countingPages{StatusPages: kf}
+	return &pageEnv{r: &StatusPageReconciler{Client: k8s, Kuma: cnt}, k8s: k8s, kuma: kf, cnt: cnt}
+}
+
+var created = metav1.NewTime(time.Date(2026, 1, 1, 0, 0, 0, 0, time.UTC))
+
+func statusPage(name string, sections ...v1.StatusPageSection) *v1.KumaStatusPage {
+	return &v1.KumaStatusPage{
+		ObjectMeta: metav1.ObjectMeta{Namespace: "default", Name: name, CreationTimestamp: created},
+		Spec: v1.KumaStatusPageSpec{
+			Slug: "renner", Title: "Renner", Description: "d", FooterText: "f", Theme: "auto",
+			DomainNames: []string{"uptime.renner.uno", "status.renner.uno"}, ShowPoweredBy: true,
+			Sections: sections,
+		},
+	}
+}
+
+func section(name string, labels map[string]string) v1.StatusPageSection {
+	return v1.StatusPageSection{Name: name, Selector: metav1.LabelSelector{MatchLabels: labels}}
+}
+
+// listed is a KumaMonitor that already has a Kuma monitor ID.
+func listed(ns, name, display string, id int64, labels map[string]string) *v1.KumaMonitor {
+	return &v1.KumaMonitor{
+		ObjectMeta: metav1.ObjectMeta{Namespace: ns, Name: name, Labels: labels},
+		Spec:       v1.KumaMonitorSpec{Type: "group", DisplayName: display},
+		Status:     v1.KumaMonitorStatus{MonitorID: id},
+	}
+}
+
+func (e *pageEnv) reconcile(t *testing.T, name string) (ctrl.Result, error) {
+	t.Helper()
+	return e.r.Reconcile(t.Context(), ctrl.Request{NamespacedName: types.NamespacedName{Namespace: "default", Name: name}})
+}
+
+func (e *pageEnv) get(t *testing.T, name string) *v1.KumaStatusPage {
+	t.Helper()
+	sp := &v1.KumaStatusPage{}
+	if err := e.k8s.Get(t.Context(), types.NamespacedName{Namespace: "default", Name: name}, sp); err != nil {
+		t.Fatal(err)
+	}
+	return sp
+}
+
+func pageReady(t *testing.T, sp *v1.KumaStatusPage) *metav1.Condition {
+	t.Helper()
+	c := meta.FindStatusCondition(sp.Status.Conditions, v1.ConditionReady)
+	if c == nil {
+		t.Fatal("no Ready condition")
+	}
+	return c
+}
+
+func monitorIDs(g kumaclient.StatusGroup) []int64 {
+	var ids []int64
+	for _, m := range g.Monitors {
+		ids = append(ids, m.ID)
+	}
+	return ids
+}
+
+var public = map[string]string{"status": "public"}
+
+func TestStatusPageCreates(t *testing.T) {
+	e := newPageEnv(t, statusPage("p", section("Core", public)), listed("a", "x", "X", 7, public))
+	res, err := e.reconcile(t, "p")
+	if err != nil {
+		t.Fatal(err)
+	}
+	if res.RequeueAfter != 5*time.Minute {
+		t.Errorf("RequeueAfter = %v", res.RequeueAfter)
+	}
+	if e.cnt.adds != 1 || e.cnt.saves != 1 {
+		t.Fatalf("adds=%d saves=%d, want 1 and 1", e.cnt.adds, e.cnt.saves)
+	}
+	got := e.kuma.Page("renner")
+	if got == nil {
+		t.Fatal("page not created")
+	}
+	want := kumaclient.StatusPage{
+		Slug: "renner", Title: "Renner", Description: "d", FooterText: "f", Theme: "auto",
+		DomainNames: []string{"status.renner.uno", "uptime.renner.uno"}, ShowPoweredBy: true,
+		Groups: []kumaclient.StatusGroup{{Name: "Core", Monitors: []kumaclient.PageMonitor{{ID: 7}}}},
+	}
+	if !got.SameContent(want) {
+		t.Errorf("page = %+v", *got)
+	}
+	sp := e.get(t, "p")
+	if c := pageReady(t, sp); c.Status != metav1.ConditionTrue || c.Reason != ReasonSynced {
+		t.Errorf("Ready = %+v", c)
+	}
+	if sp.Status.StatusPageID != got.ID || sp.Status.ObservedGeneration != sp.Generation {
+		t.Errorf("status = %+v", sp.Status)
+	}
+	if len(sp.Status.Sections) != 1 || sp.Status.Sections[0] != (v1.SectionStatus{Name: "Core", Monitors: 1}) {
+		t.Errorf("sections = %+v", sp.Status.Sections)
+	}
+	if len(sp.Finalizers) != 1 {
+		t.Errorf("finalizers = %v", sp.Finalizers)
+	}
+}
+
+func TestStatusPageAdoptsEqualWithoutWrite(t *testing.T) {
+	e := newPageEnv(t, statusPage("p", section("Core", public)), listed("a", "x", "X", 7, public))
+	e.kuma.PutPage(kumaclient.StatusPage{
+		ID: 42, Slug: "renner", Title: "Renner", Description: "d", FooterText: "f", Theme: "auto",
+		DomainNames: []string{"uptime.renner.uno", "status.renner.uno"}, ShowPoweredBy: true,
+		Groups: []kumaclient.StatusGroup{{Name: "Core", Monitors: []kumaclient.PageMonitor{{ID: 7}}}},
+	})
+	for range 2 {
+		if _, err := e.reconcile(t, "p"); err != nil {
+			t.Fatal(err)
+		}
+	}
+	if e.cnt.adds != 0 || e.cnt.saves != 0 {
+		t.Errorf("adds=%d saves=%d, want none", e.cnt.adds, e.cnt.saves)
+	}
+	if id := e.get(t, "p").Status.StatusPageID; id != 42 {
+		t.Errorf("statusPageID = %d, want 42", id)
+	}
+}
+
+func TestStatusPageNoWriteOnResync(t *testing.T) {
+	e := newPageEnv(t, statusPage("p", section("Core", public)), listed("a", "x", "X", 7, public))
+	for range 3 {
+		if _, err := e.reconcile(t, "p"); err != nil {
+			t.Fatal(err)
+		}
+	}
+	if e.cnt.adds != 1 || e.cnt.saves != 1 {
+		t.Errorf("adds=%d saves=%d, want 1 and 1", e.cnt.adds, e.cnt.saves)
+	}
+}
+
+func TestStatusPageRevertsDrift(t *testing.T) {
+	e := newPageEnv(t,
+		statusPage("p", section("Core", public), section("Edge", map[string]string{"status": "edge"})),
+		listed("a", "x", "A", 7, public), listed("a", "y", "B", 8, public),
+		listed("a", "z", "C", 9, map[string]string{"status": "edge"}))
+	if _, err := e.reconcile(t, "p"); err != nil {
+		t.Fatal(err)
+	}
+	clean := *e.kuma.Page("renner")
+	groupIDs := []int64{clean.Groups[0].ID, clean.Groups[1].ID}
+	slices.Sort(groupIDs)
+
+	drifts := map[string]func(p *kumaclient.StatusPage){
+		"title":        func(p *kumaclient.StatusPage) { p.Title = "UI" },
+		"extra domain": func(p *kumaclient.StatusPage) { p.DomainNames = append(p.DomainNames, "x.example.com") },
+		"monitor order": func(p *kumaclient.StatusPage) {
+			p.Groups[0].Monitors[0], p.Groups[0].Monitors[1] = p.Groups[0].Monitors[1], p.Groups[0].Monitors[0]
+		},
+		"group order": func(p *kumaclient.StatusPage) { p.Groups[0], p.Groups[1] = p.Groups[1], p.Groups[0] },
+		"extra group": func(p *kumaclient.StatusPage) { p.Groups = append(p.Groups, kumaclient.StatusGroup{Name: "UI"}) },
+		"extra monitor": func(p *kumaclient.StatusPage) {
+			p.Groups[1].Monitors = append(p.Groups[1].Monitors, kumaclient.PageMonitor{ID: 99})
+		},
+		"clickable link": func(p *kumaclient.StatusPage) { p.Groups[0].Monitors[0].ShowURL = true },
+		"theme":          func(p *kumaclient.StatusPage) { p.Theme = "dark" },
+		"powered by":     func(p *kumaclient.StatusPage) { p.ShowPoweredBy = false },
+	}
+	for name, drift := range drifts {
+		t.Run(name, func(t *testing.T) {
+			p := *e.kuma.Page("renner")
+			drift(&p)
+			e.kuma.PutPage(p)
+			before := e.cnt.saves
+			if _, err := e.reconcile(t, "p"); err != nil {
+				t.Fatal(err)
+			}
+			if e.cnt.saves != before+1 {
+				t.Fatalf("saves = %d, want %d", e.cnt.saves, before+1)
+			}
+			got := *e.kuma.Page("renner")
+			if !got.SameContent(clean) {
+				t.Errorf("not reverted: %+v", got)
+			}
+			// Group IDs are reused by position, so none is created or lost.
+			ids := []int64{got.Groups[0].ID, got.Groups[1].ID}
+			slices.Sort(ids)
+			if !equalIDs(ids, groupIDs) {
+				t.Errorf("group IDs %v, want %v", ids, groupIDs)
+			}
+		})
+	}
+}
+
+func TestStatusPageSectionOrderAndFirstMatch(t *testing.T) {
+	both := map[string]string{"status": "public", "tier": "core"}
+	e := newPageEnv(t,
+		statusPage("p",
+			section("Core", map[string]string{"tier": "core"}),
+			section("All", public),
+			section("Empty", map[string]string{"status": "none"})),
+		listed("b", "m", "Beta", 3, both),
+		listed("a", "m", "Alpha", 5, both),
+		listed("z", "m", "Same", 6, public),
+		listed("a", "n", "Same", 4, public),
+		listed("a", "o", "Same", 2, public),
+		listed("a", "other", "Other", 9, map[string]string{"status": "private"}),
+	)
+	if _, err := e.reconcile(t, "p"); err != nil {
+		t.Fatal(err)
+	}
+	got := e.kuma.Page("renner")
+	if len(got.Groups) != 3 {
+		t.Fatalf("groups = %+v", got.Groups)
+	}
+	wantIDs := [][]int64{{5, 3}, {4, 2, 6}, nil}
+	for i, g := range got.Groups {
+		if ids := monitorIDs(g); !equalIDs(ids, wantIDs[i]) {
+			t.Errorf("group %q monitors = %v, want %v", g.Name, ids, wantIDs[i])
+		}
+	}
+	if names := []string{got.Groups[0].Name, got.Groups[1].Name, got.Groups[2].Name}; names[0] != "Core" || names[1] != "All" || names[2] != "Empty" {
+		t.Errorf("group names = %v", names)
+	}
+	st := e.get(t, "p").Status
+	want := []v1.SectionStatus{{Name: "Core", Monitors: 2}, {Name: "All", Monitors: 3}, {Name: "Empty", Monitors: 0}}
+	if len(st.Sections) != 3 || st.Sections[0] != want[0] || st.Sections[1] != want[1] || st.Sections[2] != want[2] {
+		t.Errorf("sections = %+v", st.Sections)
+	}
+}
+
+func equalIDs(a, b []int64) bool {
+	if len(a) != len(b) {
+		return false
+	}
+	for i := range a {
+		if a[i] != b[i] {
+			return false
+		}
+	}
+	return true
+}
+
+func TestStatusPageSkipsUnsyncedAndDeleting(t *testing.T) {
+	deleting := listed("a", "gone", "Gone", 11, public)
+	deleting.Finalizers = []string{Finalizer}
+	deleting.DeletionTimestamp = &created
+	e := newPageEnv(t, statusPage("p", section("Core", public)),
+		listed("a", "x", "X", 7, public), listed("a", "new", "New", 0, public), deleting)
+	if _, err := e.reconcile(t, "p"); err != nil {
+		t.Fatal(err)
+	}
+	if ids := monitorIDs(e.kuma.Page("renner").Groups[0]); !equalIDs(ids, []int64{7}) {
+		t.Errorf("monitors = %v, want [7]", ids)
+	}
+	st := e.get(t, "p").Status
+	if st.UnsyncedMonitors != 1 || st.Sections[0].Monitors != 1 {
+		t.Errorf("status = %+v", st)
+	}
+}
+
+func TestStatusPageDelete(t *testing.T) {
+	e := newPageEnv(t, statusPage("p", section("Core", public)))
+	if _, err := e.reconcile(t, "p"); err != nil {
+		t.Fatal(err)
+	}
+	if err := e.k8s.Delete(t.Context(), e.get(t, "p")); err != nil {
+		t.Fatal(err)
+	}
+	if _, err := e.reconcile(t, "p"); err != nil {
+		t.Fatal(err)
+	}
+	if e.kuma.Page("renner") != nil {
+		t.Error("page still in Kuma")
+	}
+	if err := e.k8s.Get(t.Context(), types.NamespacedName{Namespace: "default", Name: "p"}, &v1.KumaStatusPage{}); err == nil {
+		t.Error("resource still exists")
+	}
+}
+
+func TestStatusPageDeleteWhenGoneInKuma(t *testing.T) {
+	e := newPageEnv(t, statusPage("p", section("Core", public)))
+	if _, err := e.reconcile(t, "p"); err != nil {
+		t.Fatal(err)
+	}
+	if err := e.kuma.DeleteStatusPage(t.Context(), "renner"); err != nil {
+		t.Fatal(err)
+	}
+	if err := e.k8s.Delete(t.Context(), e.get(t, "p")); err != nil {
+		t.Fatal(err)
+	}
+	if _, err := e.reconcile(t, "p"); err != nil {
+		t.Fatalf("delete of a page already gone: %v", err)
+	}
+}
+
+func TestStatusPageSlugConflict(t *testing.T) {
+	older := statusPage("older", section("Core", public))
+	newer := statusPage("newer", section("Other", public))
+	newer.CreationTimestamp = metav1.NewTime(created.Add(time.Hour))
+	newer.Spec.Title = "Newer"
+	// Left over from a sync before the conflict.
+	newer.Status = v1.KumaStatusPageStatus{
+		StatusPageID: 5, UnsyncedMonitors: 2, Sections: []v1.SectionStatus{{Name: "Other", Monitors: 3}},
+	}
+	e := newPageEnv(t, older, newer)
+
+	for _, n := range []string{"newer", "older"} {
+		if _, err := e.reconcile(t, n); err != nil {
+			t.Fatal(err)
+		}
+	}
+	c := pageReady(t, e.get(t, "newer"))
+	if c.Status != metav1.ConditionFalse || c.Reason != ReasonConflict {
+		t.Errorf("newer Ready = %+v", c)
+	}
+	if st := e.get(t, "newer").Status; st.StatusPageID != 0 || st.UnsyncedMonitors != 0 || st.Sections != nil {
+		t.Errorf("stale status kept on conflict: %+v", st)
+	}
+	if c := pageReady(t, e.get(t, "older")); c.Status != metav1.ConditionTrue {
+		t.Errorf("older Ready = %+v", c)
+	}
+	if got := e.kuma.Page("renner"); got == nil || got.Title != "Renner" {
+		t.Fatalf("page = %+v", got)
+	}
+
+	// Deleting the loser leaves the page alone.
+	if err := e.k8s.Delete(t.Context(), e.get(t, "newer")); err != nil {
+		t.Fatal(err)
+	}
+	if _, err := e.reconcile(t, "newer"); err != nil {
+		t.Fatal(err)
+	}
+	if e.kuma.Page("renner") == nil || e.cnt.deletes != 0 {
+		t.Errorf("loser deletion touched Kuma: deletes=%d", e.cnt.deletes)
+	}
+}
+
+func TestStatusPageInvalidSelector(t *testing.T) {
+	bad := v1.StatusPageSection{Name: "Bad", Selector: metav1.LabelSelector{
+		MatchExpressions: []metav1.LabelSelectorRequirement{{Key: "a", Operator: "Near"}},
+	}}
+	sp := statusPage("p", bad)
+	sp.Status = v1.KumaStatusPageStatus{
+		StatusPageID: 5, UnsyncedMonitors: 2, Sections: []v1.SectionStatus{{Name: "Old", Monitors: 3}},
+	}
+	e := newPageEnv(t, sp)
+	res, err := e.reconcile(t, "p")
+	if err != nil {
+		t.Fatal(err)
+	}
+	if res.RequeueAfter != 5*time.Minute {
+		t.Errorf("RequeueAfter = %v", res.RequeueAfter)
+	}
+	if c := pageReady(t, e.get(t, "p")); c.Status != metav1.ConditionFalse || c.Reason != ReasonInvalidSelector {
+		t.Errorf("Ready = %+v", c)
+	}
+	if st := e.get(t, "p").Status; st.StatusPageID != 5 || st.UnsyncedMonitors != 0 || st.Sections != nil {
+		t.Errorf("status = %+v, want only the page ID kept", st)
+	}
+	if e.kuma.Page("renner") != nil {
+		t.Error("page created despite invalid selector")
+	}
+}
+
+func TestStatusPageKumaUnavailable(t *testing.T) {
+	e := newPageEnv(t, statusPage("p", section("Core", public)))
+	boom := errors.New("socket closed")
+	e.kuma.SetPageErr(boom)
+	if _, err := e.reconcile(t, "p"); !errors.Is(err, boom) {
+		t.Fatalf("err = %v, want %v", err, boom)
+	}
+	if c := pageReady(t, e.get(t, "p")); c.Status != metav1.ConditionFalse || c.Reason != ReasonKumaUnavailable {
+		t.Errorf("Ready = %+v", c)
+	}
+}
+
+func TestMonitorListingChanged(t *testing.T) {
+	base := listed("a", "x", "X", 7, public)
+	now := metav1.Now()
+	cases := map[string]struct {
+		mutate func(*v1.KumaMonitor)
+		want   bool
+	}{
+		"labels":      {func(m *v1.KumaMonitor) { m.Labels = map[string]string{"status": "edge"} }, true},
+		"displayName": {func(m *v1.KumaMonitor) { m.Spec.DisplayName = "Y" }, true},
+		"monitorID":   {func(m *v1.KumaMonitor) { m.Status.MonitorID = 8 }, true},
+		"deleting":    {func(m *v1.KumaMonitor) { m.DeletionTimestamp = &now }, true},
+		"conditions": {func(m *v1.KumaMonitor) {
+			m.Status.Conditions = []metav1.Condition{{Type: v1.ConditionReady, Status: metav1.ConditionFalse}}
+		}, false},
+		"interval": {func(m *v1.KumaMonitor) { m.Spec.Interval = 120 }, false},
+	}
+	for name, c := range cases {
+		n := base.DeepCopy()
+		c.mutate(n)
+		if got := monitorListingChanged(event.UpdateEvent{ObjectOld: base, ObjectNew: n}); got != c.want {
+			t.Errorf("%s: got %v, want %v", name, got, c.want)
+		}
+	}
+}

ci/images/kuma-sync/internal/controller/statuspage_e2e_integration_test.go

@@ -0,0 +1,143 @@
+//go:build integration
+
+package controller_test
+
+import (
+	"errors"
+	"fmt"
+	"testing"
+	"time"
+
+	metav1 "k8s.io/apimachinery/pkg/apis/meta/v1"
+	"k8s.io/apimachinery/pkg/types"
+	"k8s.io/client-go/util/retry"
+
+	v1 "gitea.renner.uno/konairius/homelab/kuma-sync/api/v1alpha1"
+	"gitea.renner.uno/konairius/homelab/kuma-sync/internal/kumaclient"
+)
+
+func labeled(km *v1.KumaMonitor, labels map[string]string) *v1.KumaMonitor {
+	km.Labels = labels
+	return km
+}
+
+// pageMonitors returns the monitor IDs per group name, in order.
+func pageMonitors(p kumaclient.StatusPage) map[string][]int64 {
+	out := map[string][]int64{}
+	for _, g := range p.Groups {
+		ids := []int64{}
+		for _, m := range g.Monitors {
+			ids = append(ids, m.ID)
+		}
+		out[g.Name] = ids
+	}
+	return out
+}
+
+func TestE2EStatusPage(t *testing.T) {
+	f, env := newE2E(t)
+	// The bootstrap created the page before kuma-sync owned it.
+	if err := f.raw.AddStatusPage(t.Context(), "Old", "renner"); err != nil {
+		t.Fatal(err)
+	}
+	pre, err := f.census.GetStatusPage(t.Context(), "renner")
+	if err != nil {
+		t.Fatal(err)
+	}
+	f.start(env)
+
+	core := map[string]string{"status": "core"}
+	f.apply(
+		labeled(group("zeta", ""), core),
+		labeled(group("alpha", ""), core),
+		labeled(dns("edge", ""), map[string]string{"status": "edge"}),
+	)
+	page := &v1.KumaStatusPage{
+		ObjectMeta: metav1.ObjectMeta{Namespace: "default", Name: "public"},
+		Spec: v1.KumaStatusPageSpec{
+			Slug: "renner", Title: "Renner", DomainNames: []string{"uptime.example.com"},
+			Sections: []v1.StatusPageSection{
+				{Name: "Core", Selector: metav1.LabelSelector{MatchLabels: core}},
+				{Name: "Edge", Selector: metav1.LabelSelector{MatchLabels: map[string]string{"status": "edge"}}},
+			},
+		},
+	}
+	if err := f.k8s.Create(t.Context(), page); err != nil {
+		t.Fatal(err)
+	}
+
+	var ids map[string]int64
+	expect := func(what string, want func() map[string][]int64) {
+		t.Helper()
+		eventually(t, 60*time.Second, what, func() (bool, string) {
+			m := byKey(f.owned())
+			ids = map[string]int64{}
+			for _, k := range []string{"zeta", "alpha", "edge"} {
+				ids[k] = m["default/"+k].ID
+			}
+			p, err := f.census.GetStatusPage(t.Context(), "renner")
+			if err != nil {
+				return false, err.Error()
+			}
+			got, w := pageMonitors(p), want()
+			if p.Title != "Renner" || p.ID != pre.ID || fmt.Sprint(p.DomainNames) != "[uptime.example.com]" ||
+				len(p.Groups) != len(w) || fmt.Sprint(got) != fmt.Sprint(w) {
+				return false, fmt.Sprintf("page %+v, want groups %v", p, w)
+			}
+			return true, ""
+		})
+	}
+	expect("page adopted with sorted sections", func() map[string][]int64 {
+		return map[string][]int64{"Core": {ids["alpha"], ids["zeta"]}, "Edge": {ids["edge"]}}
+	})
+
+	cur := &v1.KumaStatusPage{}
+	if err := f.k8s.Get(t.Context(), types.NamespacedName{Namespace: "default", Name: "public"}, cur); err != nil {
+		t.Fatal(err)
+	}
+	if cur.Status.StatusPageID != pre.ID {
+		t.Errorf("statusPageID = %d, want %d", cur.Status.StatusPageID, pre.ID)
+	}
+
+	// Edit in the Kuma UI: reverted by a resync.
+	raw, err := f.raw.GetStatusPage(t.Context(), "renner")
+	if err != nil {
+		t.Fatal(err)
+	}
+	raw.Title = "UI"
+	raw.DomainNameList = []string{"other.example.com"}
+	raw.Icon = ""
+	raw.PublicGroupList = nil
+	if _, err := f.raw.SaveStatusPage(t.Context(), raw); err != nil {
+		t.Fatal(err)
+	}
+	expect("UI edit reverted", func() map[string][]int64 {
+		return map[string][]int64{"Core": {ids["alpha"], ids["zeta"]}, "Edge": {ids["edge"]}}
+	})
+
+	// Relabeling a monitor moves it.
+	if err := retry.RetryOnConflict(retry.DefaultRetry, func() error {
+		km := &v1.KumaMonitor{}
+		if err := f.k8s.Get(t.Context(), types.NamespacedName{Namespace: "default", Name: "zeta"}, km); err != nil {
+			return err
+		}
+		km.Labels = map[string]string{"status": "edge"}
+		return f.k8s.Update(t.Context(), km)
+	}); err != nil {
+		t.Fatal(err)
+	}
+	expect("relabeled monitor moved", func() map[string][]int64 {
+		return map[string][]int64{"Core": {ids["alpha"]}, "Edge": {ids["edge"], ids["zeta"]}}
+	})
+
+	if err := f.k8s.Delete(t.Context(), page); err != nil {
+		t.Fatal(err)
+	}
+	eventually(t, 30*time.Second, "page removed from Kuma", func() (bool, string) {
+		_, err := f.census.GetStatusPage(t.Context(), "renner")
+		if errors.Is(err, kumaclient.ErrStatusPageNotFound) {
+			return true, ""
+		}
+		return false, fmt.Sprintf("get: %v", err)
+	})
+}

ci/images/kuma-sync/internal/kumaclient/breml.go

@@ -158,7 +158,7 @@ func (b *Breml) checkSession(ctx context.Context, err error) (rebuilt, dead bool
 	if ctx.Err() != nil {
 		return false, false
 	}
-	for _, app := range []error{ErrNotFound, ErrNotOwned, ErrOwnerTagMissing, ErrOwnerConflict} {
+	for _, app := range []error{ErrNotFound, ErrNotOwned, ErrOwnerTagMissing, ErrOwnerConflict, ErrStatusPageNotFound} {
 		if errors.Is(err, app) {
 			return false, false
 		}
@@ -484,6 +484,11 @@ func toDomain(base monitor.Base, ownerKey string) (Monitor, error) {
 		m.Port = int32(v.Port)
 		m.DNSResolveType = string(v.ResolveType)
 		m.DNSResolveServer = v.ResolverServer
+		for _, c := range v.Conditions {
+			m.DNSConditions = append(m.DNSConditions, Condition{
+				Variable: c.Variable, Operator: c.Operator, Value: c.Value, AndOr: string(c.AndOr),
+			})
+		}
 	case "port":
 		var v monitor.TCPPort
 		if err := base.As(&v); err != nil {
@@ -566,6 +571,12 @@ func toWire(m Monitor, existing *monitor.Base) (monitor.Monitor, error) {
 		v.Port = int(m.Port)
 		v.ResolveType = monitor.DNSResolveType(m.DNSResolveType)
 		v.ResolverServer = m.DNSResolveServer
+		v.Conditions = nil
+		for _, c := range m.DNSConditions {
+			v.Conditions = append(v.Conditions, monitor.Condition{
+				Variable: c.Variable, Operator: c.Operator, Value: c.Value, AndOr: monitor.ConditionOperator(c.AndOr),
+			})
+		}
 		return v, nil
 	case "port":
 		v := &monitor.TCPPort{}

ci/images/kuma-sync/internal/kumaclient/breml_integration_test.go

@@ -160,6 +160,7 @@ func TestCreateFieldsIntact(t *testing.T) {
 		Type: "dns", Name: "dns", Description: "dns d", Active: true,
 		Interval: 90, RetryInterval: 45, MaxRetries: 1, Parent: &gid, OwnerKey: "default/dns",
 		Hostname: "example.com", DNSResolveType: "AAAA", DNSResolveServer: "1.1.1.1", Port: 53,
+		DNSConditions: []Condition{{Variable: "record", Operator: "contains", Value: ":", AndOr: "and"}},
 	}
 	port := Monitor{
 		Type: "port", Name: "port", Active: false,

ci/images/kuma-sync/internal/kumaclient/breml_statuspage.go

@@ -0,0 +1,207 @@
+package kumaclient
+
+import (
+	"context"
+	"encoding/json"
+	"errors"
+	"fmt"
+	"io"
+	"net/http"
+	"net/url"
+	"strings"
+
+	"github.com/breml/go-uptime-kuma-client/statuspage"
+)
+
+const (
+	// Messages Kuma acks for an unknown slug
+	// (server/socket-handlers/status-page-socket-handler.js).
+	msgNoSlug         = "No slug?"
+	msgPageNotFound   = "Status Page is not found"
+	defaultIconPath   = "/icon.svg"
+	maxPublicPageBody = 8 << 20
+)
+
+// pageNotFound maps Kuma's unknown-slug acks to ErrStatusPageNotFound. The
+// library formats a failed ack as "<command>: <msg>".
+func pageNotFound(slug string, err error) error {
+	if err == nil {
+		return nil
+	}
+	msg := err.Error()
+	if strings.HasSuffix(msg, ": "+msgNoSlug) || strings.HasSuffix(msg, ": "+msgPageNotFound) {
+		return fmt.Errorf("status page %q: %w", slug, errors.Join(ErrStatusPageNotFound, err))
+	}
+	return err
+}
+
+// publicPage is the part of GET /api/status-page/<slug> that the socket API
+// does not return: the groups in display order, each with its monitors in
+// display order.
+type publicPage struct {
+	PublicGroupList []struct {
+		ID          int64  `json:"id"`
+		Name        string `json:"name"`
+		MonitorList []struct {
+			ID      int64 `json:"id"`
+			SendURL any   `json:"sendUrl"`
+		} `json:"monitorList"`
+	} `json:"publicGroupList"`
+}
+
+// truthy follows JavaScript truthiness for the values sendUrl takes: a
+// boolean, or 0/1 from the database.
+func truthy(v any) bool {
+	switch x := v.(type) {
+	case bool:
+		return x
+	case float64:
+		return x != 0
+	case string:
+		return x != ""
+	}
+	return false
+}
+
+func (b *Breml) GetStatusPage(ctx context.Context, slug string) (StatusPage, error) {
+	b.mu.Lock()
+	defer b.mu.Unlock()
+	return withRecovery(ctx, b, func() (StatusPage, error) { return b.getStatusPage(ctx, slug) })
+}
+
+func (b *Breml) getStatusPage(ctx context.Context, slug string) (StatusPage, error) {
+	sp, err := b.c.GetStatusPage(ctx, slug)
+	if err != nil {
+		return StatusPage{}, pageNotFound(slug, err)
+	}
+	pub, err := b.fetchPublicPage(ctx, slug)
+	if err != nil {
+		return StatusPage{}, err
+	}
+	p := StatusPage{
+		ID:                    sp.ID,
+		Slug:                  sp.Slug,
+		Title:                 sp.Title,
+		Description:           sp.Description,
+		FooterText:            sp.FooterText,
+		Theme:                 sp.Theme,
+		DomainNames:           sp.DomainNameList,
+		ShowTags:              sp.ShowTags,
+		ShowPoweredBy:         sp.ShowPoweredBy,
+		ShowCertificateExpiry: sp.ShowCertificateExpiry,
+	}
+	for _, g := range pub.PublicGroupList {
+		group := StatusGroup{ID: g.ID, Name: g.Name}
+		for _, m := range g.MonitorList {
+			group.Monitors = append(group.Monitors, PageMonitor{ID: m.ID, ShowURL: truthy(m.SendURL)})
+		}
+		p.Groups = append(p.Groups, group)
+	}
+	return p.Normalized(), nil
+}
+
+// fetchPublicPage reads the public page data. Kuma caches the response for up
+// to five minutes and clears the cache on every saveStatusPage.
+func (b *Breml) fetchPublicPage(ctx context.Context, slug string) (publicPage, error) {
+	ctx, cancel := context.WithTimeout(ctx, operationTimeout)
+	defer cancel()
+	u := strings.TrimRight(b.url, "/") + "/api/status-page/" + url.PathEscape(slug)
+	req, err := http.NewRequestWithContext(ctx, http.MethodGet, u, nil)
+	if err != nil {
+		return publicPage{}, err
+	}
+	resp, err := http.DefaultClient.Do(req)
+	if err != nil {
+		return publicPage{}, fmt.Errorf("get public status page %q: %w", slug, err)
+	}
+	defer resp.Body.Close()
+	body, err := io.ReadAll(io.LimitReader(resp.Body, maxPublicPageBody))
+	if err != nil {
+		return publicPage{}, fmt.Errorf("get public status page %q: %w", slug, err)
+	}
+	if resp.StatusCode != http.StatusOK {
+		return publicPage{}, fmt.Errorf("get public status page %q: HTTP %d", slug, resp.StatusCode)
+	}
+	var pub publicPage
+	if err := json.Unmarshal(body, &pub); err != nil {
+		return publicPage{}, fmt.Errorf("get public status page %q: %w", slug, err)
+	}
+	return pub, nil
+}
+
+func (b *Breml) AddStatusPage(ctx context.Context, slug, title string) (int64, error) {
+	b.mu.Lock()
+	defer b.mu.Unlock()
+	if err := b.c.AddStatusPage(ctx, title, slug); err != nil {
+		// Not retried: the page may exist although the ack was lost; the next
+		// reconcile finds it.
+		b.recoverSession(ctx, err)
+		return 0, err
+	}
+	sp, err := withRecovery(ctx, b, func() (*statuspage.StatusPage, error) { return b.c.GetStatusPage(ctx, slug) })
+	if err != nil {
+		return 0, pageNotFound(slug, err)
+	}
+	return sp.ID, nil
+}
+
+func (b *Breml) SaveStatusPage(ctx context.Context, p StatusPage) error {
+	b.mu.Lock()
+	defer b.mu.Unlock()
+	_, err := withRecovery(ctx, b, func() (struct{}, error) { return struct{}{}, b.saveStatusPage(ctx, p) })
+	return err
+}
+
+// saveStatusPage starts from the page's current config, so the fields
+// kuma-sync does not manage are written back unchanged. The library never
+// sends autoRefreshInterval, rssTitle or showOnlyLastHeartbeat, which Kuma
+// then leaves as stored. Per-monitor custom URLs are not sent, so Kuma clears
+// them.
+func (b *Breml) saveStatusPage(ctx context.Context, p StatusPage) error {
+	p = p.Normalized()
+	cur, err := b.c.GetStatusPage(ctx, p.Slug)
+	if err != nil {
+		return pageNotFound(p.Slug, err)
+	}
+	sp := *cur
+	sp.Title = p.Title
+	sp.Description = p.Description
+	sp.FooterText = p.FooterText
+	sp.Theme = p.Theme
+	sp.ShowTags = p.ShowTags
+	sp.ShowPoweredBy = p.ShowPoweredBy
+	sp.ShowCertificateExpiry = p.ShowCertificateExpiry
+	// Kuma rejects anything but an array.
+	sp.DomainNameList = append([]string{}, p.DomainNames...)
+	// Kuma reports an unset logo as its default path; writing that back would
+	// store it.
+	if sp.Icon == defaultIconPath {
+		sp.Icon = ""
+	}
+	sp.PublicGroupList = make([]statuspage.PublicGroup, 0, len(p.Groups))
+	for _, g := range p.Groups {
+		group := statuspage.PublicGroup{ID: g.ID, Name: g.Name, MonitorList: []statuspage.PublicMonitor{}}
+		for _, m := range g.Monitors {
+			pm := statuspage.PublicMonitor{ID: m.ID}
+			if m.ShowURL {
+				show := true
+				pm.SendURL = &show
+			}
+			group.MonitorList = append(group.MonitorList, pm)
+		}
+		sp.PublicGroupList = append(sp.PublicGroupList, group)
+	}
+	if _, err := b.c.SaveStatusPage(ctx, &sp); err != nil {
+		return pageNotFound(p.Slug, err)
+	}
+	return nil
+}
+
+func (b *Breml) DeleteStatusPage(ctx context.Context, slug string) error {
+	b.mu.Lock()
+	defer b.mu.Unlock()
+	_, err := withRecovery(ctx, b, func() (struct{}, error) {
+		return struct{}{}, pageNotFound(slug, b.c.DeleteStatusPage(ctx, slug))
+	})
+	return err
+}

ci/images/kuma-sync/internal/kumaclient/client.go

@@ -19,6 +19,8 @@ var (
 	ErrOwnerConflict = errors.New("monitor carries conflicting kuma-sync tag values")
 	// ErrPossibleOrphan means Create may have left an untagged monitor in Kuma.
 	ErrPossibleOrphan = errors.New("possible untagged orphan monitor left in Kuma")
+	// ErrStatusPageNotFound means no status page has the slug.
+	ErrStatusPageNotFound = errors.New("status page not found")
 )
 
 // ConflictError reports a monitor carrying several different kuma-sync tag
@@ -64,6 +66,7 @@ func (m Monitor) clone() Monitor {
 	m.Headers = maps.Clone(m.Headers)
 	m.AcceptedStatusCodes = slices.Clone(m.AcceptedStatusCodes)
 	m.NotificationIDs = slices.Clone(m.NotificationIDs)
+	m.DNSConditions = slices.Clone(m.DNSConditions)
 	if m.Parent != nil {
 		p := *m.Parent
 		m.Parent = &p
@@ -96,6 +99,9 @@ func (m Monitor) Normalized() Monitor {
 	if len(m.AcceptedStatusCodes) == 0 {
 		m.AcceptedStatusCodes = nil
 	}
+	if len(m.DNSConditions) == 0 {
+		m.DNSConditions = nil
+	}
 	if !isHTTPFamily(m.Type) {
 		m.Timeout = 0
 		return m
@@ -112,6 +118,15 @@ func (m Monitor) Normalized() Monitor {
 	return m
 }
 
+// Condition is one flat Kuma monitor condition.
+type Condition struct {
+	Variable string
+	Operator string
+	Value    string
+	// AndOr joins the condition to the previous one: "and" or "or".
+	AndOr string
+}
+
 // Monitor is the domain view of a Kuma monitor.
 type Monitor struct {
 	ID          int64
@@ -149,6 +164,7 @@ type Monitor struct {
 	Port             int32
 	DNSResolveType   string
 	DNSResolveServer string
+	DNSConditions    []Condition
 
 	// NotificationIDs are the Kuma notifications attached to the monitor.
 	NotificationIDs []int64
@@ -183,4 +199,6 @@ type Client interface {
 	// DefaultNotifications returns the IDs of all notifications marked
 	// "default enabled" in Kuma, sorted. An empty result is valid.
 	DefaultNotifications(ctx context.Context) ([]int64, error)
+
+	StatusPages
 }

ci/images/kuma-sync/internal/kumaclient/dns_conditions_test.go

@@ -0,0 +1,78 @@
+package kumaclient
+
+import (
+	"encoding/json"
+	"reflect"
+	"testing"
+
+	"github.com/breml/go-uptime-kuma-client/monitor"
+)
+
+// The wire form must carry DNS conditions to Kuma and read them back unchanged.
+func TestDNSConditionsRoundTrip(t *testing.T) {
+	m := Monitor{
+		ID: 7, Type: "dns", Name: "d", Active: true, Interval: 60, RetryInterval: 60,
+		Hostname: "a.example", DNSResolveType: "CNAME", DNSResolveServer: "1.1.1.1", Port: 53,
+		DNSConditions: []Condition{{Variable: "record", Operator: "equals", Value: "t.example", AndOr: "and"}},
+		OwnerKey:      "ns/d",
+	}
+	w, err := toWire(m, nil)
+	if err != nil {
+		t.Fatal(err)
+	}
+	raw, err := json.Marshal(w)
+	if err != nil {
+		t.Fatal(err)
+	}
+	var wire struct {
+		Conditions []map[string]string `json:"conditions"`
+	}
+	if err := json.Unmarshal(raw, &wire); err != nil {
+		t.Fatal(err)
+	}
+	wantWire := []map[string]string{{"type": "expression", "variable": "record", "operator": "equals", "value": "t.example", "andOr": "and"}}
+	if !reflect.DeepEqual(wire.Conditions, wantWire) {
+		t.Fatalf("wire conditions: got %v want %v", wire.Conditions, wantWire)
+	}
+	var base monitor.Base
+	if err := json.Unmarshal(raw, &base); err != nil {
+		t.Fatal(err)
+	}
+	got, err := toDomain(base, "ns/d")
+	if err != nil {
+		t.Fatal(err)
+	}
+	if !reflect.DeepEqual(got.DNSConditions, m.DNSConditions) {
+		t.Fatalf("read back: got %+v want %+v", got.DNSConditions, m.DNSConditions)
+	}
+}
+
+// Removing every condition must clear them in Kuma, not keep the stored ones.
+func TestDNSConditionsClearedOnUpdate(t *testing.T) {
+	stored := []byte(`{"id":7,"type":"dns","name":"d","hostname":"a.example","dns_resolve_type":"CNAME",` +
+		`"dns_resolve_server":"1.1.1.1","port":53,"conditions":[{"type":"expression","variable":"record","operator":"equals","value":"x","andOr":"and"}]}`)
+	var existing monitor.Base
+	if err := json.Unmarshal(stored, &existing); err != nil {
+		t.Fatal(err)
+	}
+	m := Monitor{ID: 7, Type: "dns", Name: "d", Hostname: "a.example", DNSResolveType: "CNAME", DNSResolveServer: "1.1.1.1", Port: 53}
+	w, err := toWire(m, &existing)
+	if err != nil {
+		t.Fatal(err)
+	}
+	raw, _ := json.Marshal(w)
+	var wire struct {
+		Conditions []any `json:"conditions"`
+	}
+	_ = json.Unmarshal(raw, &wire)
+	if wire.Conditions == nil || len(wire.Conditions) != 0 {
+		t.Fatalf("conditions not cleared: %s", raw)
+	}
+}
+
+func TestNormalizedDNSConditions(t *testing.T) {
+	m := Monitor{Type: "dns", DNSConditions: []Condition{}}.Normalized()
+	if m.DNSConditions != nil {
+		t.Errorf("empty conditions must normalize to nil")
+	}
+}

ci/images/kuma-sync/internal/kumaclient/fake.go

@@ -28,6 +28,13 @@ type Fake struct {
 	// ListPartial makes ListOwned return the stored monitors together with
 	// ListErr, as the real client does for owner conflicts.
 	ListPartial bool
+
+	pages       map[string]StatusPage
+	pageGroups  map[int64]string // group ID -> page slug
+	nextPageID  int64
+	nextGroupID int64
+	// PageErr, when set, is returned by every status page method.
+	PageErr error
 }
 
 // SetListPartial makes ListOwned return the stored monitors and err.
@@ -40,7 +47,10 @@ func (f *Fake) SetListPartial(err error) {
 var _ Client = (*Fake)(nil)
 
 func NewFake() *Fake {
-	return &Fake{monitors: map[int64]Monitor{}, nextID: 1}
+	return &Fake{
+		monitors: map[int64]Monitor{}, nextID: 1,
+		pages: map[string]StatusPage{}, pageGroups: map[int64]string{}, nextPageID: 1, nextGroupID: 1,
+	}
 }
 
 // AddForeign adds an untagged monitor. A zero ID is assigned the next free one.

ci/images/kuma-sync/internal/kumaclient/fake_statuspage.go

@@ -0,0 +1,127 @@
+package kumaclient
+
+import (
+	"context"
+	"fmt"
+)
+
+// SetPageErr makes every status page method return err.
+func (f *Fake) SetPageErr(err error) {
+	f.mu.Lock()
+	defer f.mu.Unlock()
+	f.PageErr = err
+}
+
+// Page returns a copy of the stored page, or nil.
+func (f *Fake) Page(slug string) *StatusPage {
+	f.mu.Lock()
+	defer f.mu.Unlock()
+	p, ok := f.pages[slug]
+	if !ok {
+		return nil
+	}
+	c := p.clone()
+	return &c
+}
+
+// PutPage stores p as if edited in the Kuma UI. Groups with ID 0 get new IDs.
+func (f *Fake) PutPage(p StatusPage) {
+	f.mu.Lock()
+	defer f.mu.Unlock()
+	if cur, ok := f.pages[p.Slug]; ok {
+		p.ID = cur.ID
+	} else if p.ID == 0 {
+		p.ID = f.nextPageID
+		f.nextPageID++
+	}
+	f.storeGroups(&p)
+	f.pages[p.Slug] = p.Normalized()
+}
+
+// storeGroups assigns IDs to new groups and drops the page's other groups.
+func (f *Fake) storeGroups(p *StatusPage) {
+	p.Groups = p.clone().Groups
+	keep := map[int64]bool{}
+	for i := range p.Groups {
+		if p.Groups[i].ID == 0 {
+			p.Groups[i].ID = f.nextGroupID
+			f.nextGroupID++
+		}
+		keep[p.Groups[i].ID] = true
+		f.pageGroups[p.Groups[i].ID] = p.Slug
+	}
+	for id, slug := range f.pageGroups {
+		if slug == p.Slug && !keep[id] {
+			delete(f.pageGroups, id)
+		}
+	}
+}
+
+func (f *Fake) GetStatusPage(_ context.Context, slug string) (StatusPage, error) {
+	f.mu.Lock()
+	defer f.mu.Unlock()
+	if f.PageErr != nil {
+		return StatusPage{}, f.PageErr
+	}
+	p, ok := f.pages[slug]
+	if !ok {
+		return StatusPage{}, fmt.Errorf("status page %q: %w", slug, ErrStatusPageNotFound)
+	}
+	return p.clone(), nil
+}
+
+// AddStatusPage stores the defaults Kuma's addStatusPage writes.
+func (f *Fake) AddStatusPage(_ context.Context, slug, title string) (int64, error) {
+	f.mu.Lock()
+	defer f.mu.Unlock()
+	if f.PageErr != nil {
+		return 0, f.PageErr
+	}
+	if _, ok := f.pages[slug]; ok {
+		return 0, fmt.Errorf("add status page %q: slug exists", slug)
+	}
+	p := StatusPage{ID: f.nextPageID, Slug: slug, Title: title, Theme: "auto", ShowPoweredBy: true}
+	f.nextPageID++
+	f.pages[slug] = p
+	return p.ID, nil
+}
+
+// SaveStatusPage rejects a group ID of another page, as Kuma fails on it.
+func (f *Fake) SaveStatusPage(_ context.Context, p StatusPage) error {
+	f.mu.Lock()
+	defer f.mu.Unlock()
+	if f.PageErr != nil {
+		return f.PageErr
+	}
+	cur, ok := f.pages[p.Slug]
+	if !ok {
+		return fmt.Errorf("status page %q: %w", p.Slug, ErrStatusPageNotFound)
+	}
+	for _, g := range p.Groups {
+		if g.ID != 0 && f.pageGroups[g.ID] != p.Slug {
+			return fmt.Errorf("save status page %q: group %d not on this page", p.Slug, g.ID)
+		}
+	}
+	p.ID = cur.ID
+	f.storeGroups(&p)
+	f.pages[p.Slug] = p.Normalized()
+	return nil
+}
+
+func (f *Fake) DeleteStatusPage(_ context.Context, slug string) error {
+	f.mu.Lock()
+	defer f.mu.Unlock()
+	if f.PageErr != nil {
+		return f.PageErr
+	}
+	if _, ok := f.pages[slug]; !ok {
+		return fmt.Errorf("status page %q: %w", slug, ErrStatusPageNotFound)
+	}
+	delete(f.pages, slug)
+	for id, s := range f.pageGroups {
+		if s == slug {
+			delete(f.pageGroups, id)
+		}
+	}
+	return nil
+}

ci/images/kuma-sync/internal/kumaclient/statuspage.go

@@ -0,0 +1,110 @@
+package kumaclient
+
+import (
+	"context"
+	"slices"
+	"strings"
+)
+
+// StatusPage is the domain view of a Kuma status page. Fields kuma-sync does
+// not manage (logo, custom CSS, analytics, RSS title, auto refresh interval)
+// are kept as they are in Kuma. Per-monitor custom URLs are not kept: every
+// save clears them.
+type StatusPage struct {
+	// ID is read only.
+	ID          int64
+	Slug        string
+	Title       string
+	Description string
+	FooterText  string
+	Theme       string
+	// DomainNames is a set; Kuma returns it in no defined order.
+	DomainNames           []string
+	ShowTags              bool
+	ShowPoweredBy         bool
+	ShowCertificateExpiry bool
+	// Groups are in display order.
+	Groups []StatusGroup
+}
+
+// StatusGroup is one section of a status page.
+type StatusGroup struct {
+	// ID is Kuma's group ID; 0 creates a new group on save.
+	ID       int64
+	Name     string
+	Monitors []PageMonitor
+}
+
+// PageMonitor is one monitor of a group, in display order.
+type PageMonitor struct {
+	ID int64
+	// ShowURL is Kuma's per-page "show clickable link" setting.
+	ShowURL bool
+}
+
+// Normalized returns p with DomainNames trimmed, sorted and deduplicated,
+// blank names dropped, and empty slices nil. It is idempotent.
+func (p StatusPage) Normalized() StatusPage {
+	var domains []string
+	for _, d := range p.DomainNames {
+		if d = strings.TrimSpace(d); d != "" {
+			domains = append(domains, d)
+		}
+	}
+	slices.Sort(domains)
+	p.DomainNames = slices.Compact(domains)
+	var groups []StatusGroup
+	for _, g := range p.Groups {
+		g.Monitors = slices.Clone(g.Monitors)
+		if len(g.Monitors) == 0 {
+			g.Monitors = nil
+		}
+		groups = append(groups, g)
+	}
+	p.Groups = groups
+	return p
+}
+
+// SameContent reports whether p and o hold the same managed content. IDs are
+// ignored.
+func (p StatusPage) SameContent(o StatusPage) bool {
+	a, b := p.Normalized(), o.Normalized()
+	if a.Slug != b.Slug || a.Title != b.Title || a.Description != b.Description ||
+		a.FooterText != b.FooterText || a.Theme != b.Theme ||
+		a.ShowTags != b.ShowTags || a.ShowPoweredBy != b.ShowPoweredBy ||
+		a.ShowCertificateExpiry != b.ShowCertificateExpiry ||
+		!slices.Equal(a.DomainNames, b.DomainNames) || len(a.Groups) != len(b.Groups) {
+		return false
+	}
+	for i := range a.Groups {
+		if a.Groups[i].Name != b.Groups[i].Name || !slices.Equal(a.Groups[i].Monitors, b.Groups[i].Monitors) {
+			return false
+		}
+	}
+	return true
+}
+
+func (p StatusPage) clone() StatusPage {
+	p.DomainNames = slices.Clone(p.DomainNames)
+	p.Groups = slices.Clone(p.Groups)
+	for i := range p.Groups {
+		p.Groups[i].Monitors = slices.Clone(p.Groups[i].Monitors)
+	}
+	return p
+}
+
+// StatusPages manages Kuma status pages by slug.
+type StatusPages interface {
+	// GetStatusPage returns the page with its groups. It wraps
+	// ErrStatusPageNotFound when no page has this slug.
+	GetStatusPage(ctx context.Context, slug string) (StatusPage, error)
+	// AddStatusPage creates an empty page and returns its ID.
+	AddStatusPage(ctx context.Context, slug, title string) (int64, error)
+	// SaveStatusPage writes the managed fields and replaces the group list.
+	// Every non-zero group ID must belong to the page; groups not listed are
+	// deleted. It wraps ErrStatusPageNotFound when no page has this slug.
+	SaveStatusPage(ctx context.Context, p StatusPage) error
+	// DeleteStatusPage removes the page with its groups and incidents. It
+	// wraps ErrStatusPageNotFound when no page has this slug.
+	DeleteStatusPage(ctx context.Context, slug string) error
+}

ci/images/kuma-sync/internal/kumaclient/statuspage_integration_test.go

@@ -0,0 +1,172 @@
+//go:build integration
+
+package kumaclient
+
+import (
+	"context"
+	"encoding/json"
+	"errors"
+	"net/http"
+	"testing"
+
+	"github.com/breml/go-uptime-kuma-client/statuspage"
+)
+
+func TestStatusPageRoundTrip(t *testing.T) {
+	ctx := context.Background()
+	url := startKuma(t)
+	b := setupClient(t, url)
+	var ids []int64
+	for _, name := range []string{"m1", "m2", "m3"} {
+		id, err := b.Create(ctx, Monitor{Type: "group", Name: name, Active: true, Interval: 60, RetryInterval: 60, OwnerKey: "a/" + name})
+		if err != nil {
+			t.Fatal(err)
+		}
+		ids = append(ids, id)
+	}
+
+	pageID, err := b.AddStatusPage(ctx, "renner", "Renner")
+	if err != nil {
+		t.Fatal(err)
+	}
+	fresh, err := b.GetStatusPage(ctx, "renner")
+	if err != nil {
+		t.Fatal(err)
+	}
+	if fresh.ID != pageID || fresh.Title != "Renner" || fresh.Theme != "auto" || len(fresh.Groups) != 0 {
+		t.Fatalf("new page = %+v", fresh)
+	}
+
+	// An unmanaged field set in the UI.
+	raw, err := b.c.GetStatusPage(ctx, "renner")
+	if err != nil {
+		t.Fatal(err)
+	}
+	raw.CustomCSS = "body{}"
+	raw.Icon = ""
+	if _, err := b.c.SaveStatusPage(ctx, raw); err != nil {
+		t.Fatal(err)
+	}
+
+	want := StatusPage{
+		Slug: "renner", Title: "Status", Description: "desc", FooterText: "foot", Theme: "dark",
+		DomainNames: []string{"uptime.example.com", "status.example.com"},
+		ShowTags:    true, ShowPoweredBy: false, ShowCertificateExpiry: true,
+		Groups: []StatusGroup{
+			{Name: "Core", Monitors: []PageMonitor{{ID: ids[2]}, {ID: ids[0]}}},
+			{Name: "Empty"},
+			{Name: "Edge", Monitors: []PageMonitor{{ID: ids[1]}}},
+		},
+	}
+	if err := b.SaveStatusPage(ctx, want); err != nil {
+		t.Fatal(err)
+	}
+	got, err := freshClient(t, url).GetStatusPage(ctx, "renner")
+	if err != nil {
+		t.Fatal(err)
+	}
+	if !got.SameContent(want) || got.ID != pageID {
+		t.Fatalf("read back:\n got  %+v\n want %+v", got, want)
+	}
+	for _, g := range got.Groups {
+		if g.ID == 0 {
+			t.Fatalf("group without ID: %+v", got.Groups)
+		}
+	}
+
+	// Saving with the read group IDs keeps them.
+	again := want
+	again.Groups = got.Groups
+	if err := b.SaveStatusPage(ctx, again); err != nil {
+		t.Fatal(err)
+	}
+	after, err := b.GetStatusPage(ctx, "renner")
+	if err != nil {
+		t.Fatal(err)
+	}
+	for i := range after.Groups {
+		if after.Groups[i].ID != got.Groups[i].ID {
+			t.Errorf("group %d ID %d -> %d", i, got.Groups[i].ID, after.Groups[i].ID)
+		}
+	}
+
+	raw, err = b.c.GetStatusPage(ctx, "renner")
+	if err != nil {
+		t.Fatal(err)
+	}
+	if raw.CustomCSS != "body{}" || raw.Icon != "/icon.svg" {
+		t.Errorf("unmanaged fields changed: customCSS=%q icon=%q", raw.CustomCSS, raw.Icon)
+	}
+
+	// Config keys the library never sends keep their stored values.
+	resp, err := http.Get(url + "/api/status-page/renner")
+	if err != nil {
+		t.Fatal(err)
+	}
+	defer resp.Body.Close()
+	var pub struct {
+		Config map[string]any `json:"config"`
+	}
+	if err := json.NewDecoder(resp.Body).Decode(&pub); err != nil {
+		t.Fatal(err)
+	}
+	for key, want := range map[string]any{"autoRefreshInterval": float64(300), "showOnlyLastHeartbeat": false, "rssTitle": nil} {
+		if got, ok := pub.Config[key]; !ok || got != want {
+			t.Errorf("config.%s = %#v (present %v), want %#v", key, got, ok, want)
+		}
+	}
+}
+
+func TestStatusPageShowURLReadBack(t *testing.T) {
+	ctx := context.Background()
+	b := setupClient(t, startKuma(t))
+	id, err := b.Create(ctx, Monitor{
+		Type: "http", Name: "h", Active: false, Interval: 60, RetryInterval: 60,
+		URL: "https://example.com", OwnerKey: "a/h",
+	})
+	if err != nil {
+		t.Fatal(err)
+	}
+	if _, err := b.AddStatusPage(ctx, "renner", "Renner"); err != nil {
+		t.Fatal(err)
+	}
+	raw, err := b.c.GetStatusPage(ctx, "renner")
+	if err != nil {
+		t.Fatal(err)
+	}
+	show := true
+	raw.PublicGroupList = []statuspage.PublicGroup{{Name: "G", MonitorList: []statuspage.PublicMonitor{{ID: id, SendURL: &show}}}}
+	if _, err := b.c.SaveStatusPage(ctx, raw); err != nil {
+		t.Fatal(err)
+	}
+	got, err := b.GetStatusPage(ctx, "renner")
+	if err != nil {
+		t.Fatal(err)
+	}
+	if len(got.Groups) != 1 || len(got.Groups[0].Monitors) != 1 || !got.Groups[0].Monitors[0].ShowURL {
+		t.Errorf("groups = %+v", got.Groups)
+	}
+}
+
+func TestStatusPageNotFound(t *testing.T) {
+	ctx := context.Background()
+	b := setupClient(t, startKuma(t))
+	if _, err := b.GetStatusPage(ctx, "missing"); !errors.Is(err, ErrStatusPageNotFound) {
+		t.Errorf("get: %v", err)
+	}
+	if err := b.SaveStatusPage(ctx, StatusPage{Slug: "missing", Title: "x", Theme: "auto"}); !errors.Is(err, ErrStatusPageNotFound) {
+		t.Errorf("save: %v", err)
+	}
+	if err := b.DeleteStatusPage(ctx, "missing"); !errors.Is(err, ErrStatusPageNotFound) {
+		t.Errorf("delete: %v", err)
+	}
+	if _, err := b.AddStatusPage(ctx, "here", "Here"); err != nil {
+		t.Fatal(err)
+	}
+	if err := b.DeleteStatusPage(ctx, "here"); err != nil {
+		t.Fatal(err)
+	}
+	if _, err := b.GetStatusPage(ctx, "here"); !errors.Is(err, ErrStatusPageNotFound) {
+		t.Errorf("get after delete: %v", err)
+	}
+}

ci/images/kuma-sync/internal/kumaclient/statuspage_test.go

@@ -0,0 +1,67 @@
+package kumaclient
+
+import (
+	"errors"
+	"testing"
+)
+
+func TestStatusPageSameContent(t *testing.T) {
+	base := StatusPage{
+		ID: 1, Slug: "s", Title: "T", Theme: "auto", DomainNames: []string{"b.example", "a.example"},
+		Groups: []StatusGroup{{ID: 3, Name: "G", Monitors: []PageMonitor{{ID: 1}, {ID: 2}}}},
+	}
+	same := StatusPage{
+		ID: 9, Slug: "s", Title: "T", Theme: "auto", DomainNames: []string{"a.example", " b.example", "", "a.example"},
+		Groups: []StatusGroup{{ID: 0, Name: "G", Monitors: []PageMonitor{{ID: 1}, {ID: 2}}}},
+	}
+	if !base.SameContent(same) {
+		t.Error("IDs, domain order, blanks and duplicates must not count")
+	}
+	emptyGroup := StatusPage{Groups: []StatusGroup{{Name: "G", Monitors: []PageMonitor{}}}}
+	if !emptyGroup.SameContent(StatusPage{Groups: []StatusGroup{{Name: "G"}}}) {
+		t.Error("empty and nil monitor lists must be equal")
+	}
+	diffs := map[string]func(p *StatusPage){
+		"monitor order": func(p *StatusPage) { p.Groups[0].Monitors = []PageMonitor{{ID: 2}, {ID: 1}} },
+		"show url":      func(p *StatusPage) { p.Groups[0].Monitors[0].ShowURL = true },
+		"group name":    func(p *StatusPage) { p.Groups[0].Name = "H" },
+		"extra group":   func(p *StatusPage) { p.Groups = append(p.Groups, StatusGroup{Name: "H"}) },
+		"domain":        func(p *StatusPage) { p.DomainNames = []string{"a.example"} },
+		"footer":        func(p *StatusPage) { p.FooterText = "f" },
+		"cert expiry":   func(p *StatusPage) { p.ShowCertificateExpiry = true },
+	}
+	for name, mutate := range diffs {
+		p := base.clone()
+		mutate(&p)
+		if base.SameContent(p) {
+			t.Errorf("%s: change not detected", name)
+		}
+	}
+}
+
+func TestTruthy(t *testing.T) {
+	for _, c := range []struct {
+		v    any
+		want bool
+	}{{nil, false}, {false, false}, {true, true}, {float64(0), false}, {float64(1), true}, {"", false}} {
+		if got := truthy(c.v); got != c.want {
+			t.Errorf("truthy(%#v) = %v", c.v, got)
+		}
+	}
+}
+
+func TestPageNotFound(t *testing.T) {
+	for _, msg := range []string{
+		"get status page s: getStatusPage: No slug?",
+		"save status page: saveStatusPage: No slug?",
+		"delete status page: deleteStatusPage: Status Page is not found",
+	} {
+		if err := pageNotFound("s", errors.New(msg)); !errors.Is(err, ErrStatusPageNotFound) {
+			t.Errorf("%q not mapped", msg)
+		}
+	}
+	other := errors.New("save status page: saveStatusPage: Invalid Slug")
+	if err := pageNotFound("s", other); errors.Is(err, ErrStatusPageNotFound) {
+		t.Error("other error mapped to not found")
+	}
+}

docs/superpowers/plans/2026-10-18-homelab-konairius-main.md

@@ -28,7 +28,7 @@
 ## Review Focus
 
 1. **Flux fetch across the transfer.** Flux's GitRepository fetches `k.renner/homelab.git` until the URL change lands. Documented behaviour says this works: source-controller v1.9.5 uses go-git v5.19.1 (its `go.mod`), whose `RedirectPolicy` "mirror[s] Git's http.followRedirects config" with the zero value `initial` (pkg.go.dev); git documents `initial` as following the redirect on the first request and using "the redirected URL as the base for the follow-up requests" (`git-config`, `http.followRedirects`). Gitea's 301 stays on the same host and scheme, so fetch and the IUA push both reach `konairius/homelab`. Fallback only, should that fail: Task 3 has a declared break-glass (suspend the `flux-system` Kustomization so it cannot re-apply the old URL, patch the GitRepository URL to the value the PR sets, resume once the source is Ready on the merge commit), checked by `flux get source git flux-system`.
-6. **Write access lost in the transfer.** Any writer that is a konairius org member loses its collaborator grant and keeps only its team permission (`flux` pushes for image automation; claude-bot, issue-fix-bot, security-bot, review-bot, argus-bot, renovate-bot write PRs/reviews). Expect: Task 3 Step 0 snapshot of collaborators, konairius teams and the branch-protection whitelists, compared after Step 1.
+6. **Write access lost in the transfer.** Any writer that is a konairius org member loses its collaborator grant and keeps only its team permission (`flux` pushes for image automation; claude-bot, issue-fix-bot, security-bot, review-bot, argus-bot, renovate-bot write PRs/reviews). Expect: Task 3 Step 0 snapshot of collaborators and the `master` protection, compared after Step 1 (memberships confirmed fine by the owner).
 2. **Image automation push between merge and rename (Cut-over 2).** The IUA pushes to `master`; after the Task 5 PR it expects `main`. Expect: IUA suspended for the whole window and resumed only after Flux reports `main`.
 3. **Org secrets after the Woodpecker move.** Homelab pipelines use the org secrets `claude_code_oauth_token` and `review_bot_token`; after the move they resolve in `konairius`. Expect: both exist in `konairius` before Cut-over 1 (Task 1 verification).
 4. **Crons on a vanished branch.** All 7 crons run on `master`. Expect: each switched to `main` in place (`woodpecker repo cron update --branch main`) inside the Cut-over 2 window, verified by `cron ls`.
@@ -70,11 +70,11 @@
 
 **Preconditions:** Task 1 verified; Task 2 PR green; no deploy pipeline running (`woodpecker pipeline ls k.renner/homelab --limit 5`); record `flux get source git flux-system` revision.
 
-- [ ] **Step 0 (owner, needs admin):** snapshot `tea api --login renner.uno /repos/k.renner/homelab/collaborators`, `tea api --login renner.uno /orgs/konairius/teams` plus each team's members, and the `master` rule's push/merge/approvals whitelists (`tea api --login renner.uno /repos/k.renner/homelab/branch_protections`). Any writer that is a konairius member must get write access through its team, or be re-added as collaborator right after Step 1.
+- [ ] **Step 0 (claude-bot):** snapshot `tea api --login claude-bot /repos/k.renner/homelab/collaborators` (2026-10-19: security-bot, claude-bot, alert-monitor-bot, issue-fix-bot, update-audit-bot, review-bot, flux, renovate-bot, hermes-bot) and `/repos/k.renner/homelab/branches/master` (`protected: true`, `required_approvals: 1`). konairius memberships confirmed fine by the owner; whitelists need admin and are not snapshotted.
 - [ ] **Step 1 (owner):** `tea api --login renner.uno -X POST /repos/k.renner/homelab/transfer -f new_owner=konairius`. Expect `curl -sI https://gitea.renner.uno/k.renner/homelab` → 301.
 - [ ] **Step 2 (claude-bot):** Woodpecker move: `POST $WOODPECKER_SERVER/api/repos/1/move?to=konairius/homelab` → 204; `woodpecker repo ls` shows `konairius/homelab`.
 - [ ] **Step 3 (owner):** merge the Task 2 PR.
-- [ ] **Step 1a:** repeat the Step 0 reads against `konairius/homelab` and compare; re-add any lost writer as collaborator before continuing.
+- [ ] **Step 1a (claude-bot):** repeat the Step 0 reads against `konairius/homelab` and compare; a missing writer is re-added by the owner before continuing.
 - [ ] **Step 4:** `flux reconcile source git flux-system`. If it fails to fetch: break-glass — `flux suspend kustomization flux-system` (else it re-applies the last good artifact with the old URL), then `kubectl -n flux-system patch gitrepository flux-system --type merge -p '{"spec":{"url":"https://gitea.renner.uno/konairius/homelab.git"}}'` (the value the PR sets), wait for the source to be Ready on the Task 2 merge commit, then `flux resume kustomization flux-system`. Expect: revision = Task 2 merge commit, Ready.
 - [ ] **Step 5:** `flux reconcile image update homelab` after the next ImagePolicy change, or check the last IUA push reaches `konairius/homelab` (commit by Flux Image Automation on master).
 - [ ] **Step 6:** Run flux-git rotator once (`kubectl create job -n openbao --from=cronjob/flux-git-secret-rotate flux-git-move`); log shows `pull+push verified` against `konairius/homelab`.
@@ -112,8 +112,8 @@
 - [ ] **Step 1:** `flux suspend image update homelab`.
 - [ ] **Step 2 (owner):** merge the Task 5 PR into `master`. Flux now points at `main`, which does not exist yet; the cluster keeps its last applied state.
 - [ ] **Step 3 (owner, immediately):** `tea api --login renner.uno -X PATCH /repos/konairius/homelab/branches/master -f name=main`. Expect: default branch `main`, protection rule now named `main` (`GET /repos/konairius/homelab/branches/main` → `protected: true, required_approvals: 1`), open PRs based on `main`.
-- [ ] **Step 4:** `flux reconcile source git flux-system` → Ready on `main@<merge commit>`; `flux get kustomizations` all Ready.
-- [ ] **Step 5:** Crons: for each of `alert-monitor`(4), `ci-claude-refresh`(7), `daily-security-scan`(2), `issue-fix`(5), `update-audit`(3), `weekly-update`(1): `woodpecker repo cron update --repository konairius/homelab --id <id> --branch main`. Delete `wiki-maintenance`(8): no pipeline filters on it (`git grep wiki-maintenance -- .woodpecker` is empty), it starts nothing. `cron ls` shows six crons, all on `main`.
+- [ ] **Step 4:** the live GitRepository still has `ref.branch: master` and cannot fetch the commit that changes it (`couldn't find remote ref "refs/heads/master"`). `flux suspend kustomization flux-system`, `kubectl -n flux-system patch gitrepository flux-system --type merge -p '{"spec":{"ref":{"branch":"main"}}}'`, `flux resume kustomization flux-system` → Ready on `main`; `flux get kustomizations` all Ready.
+- [ ] **Step 5:** Crons: for each of `alert-monitor`(4), `ci-claude-refresh`(7), `daily-security-scan`(2), `issue-fix`(5), `update-audit`(3), `weekly-update`(1), `uptime-kuma-token-renew`(10): `PATCH $WOODPECKER_SERVER/api/repos/1/cron/<id>` with `{"branch":"main"}` (woodpecker-cli 3.18.0 `repo cron update` returns 404 against server 3.19.0). Delete `wiki-maintenance`(8): no pipeline filters on it (`git grep wiki-maintenance -- .woodpecker` is empty), it starts nothing. `cron ls` shows seven crons, all on `main`.
 - [ ] **Step 6:** `woodpecker repo repair konairius/homelab`; `woodpecker repo show` shows branch `main`.
 - [ ] **Step 7:** `flux resume image update homelab`; next IUA commit lands on `main`.
 - [ ] **Step 8:** Verify: a small PR into `main` gets reviewed and its merge triggers the push pipelines; the deploy pipelines' `when: branch: main` fire.

kubernetes/RUNBOOK-cold-rebuild.md

@@ -23,7 +23,7 @@ bare-metal conversions were driven. Find the leases on the UDM.
 ## The circular-bootstrap problem this runbook exists to break
 
 In steady state Flux's `GitRepository flux-system` pulls manifests from the
-**in-cluster** Gitea (`https://gitea.renner.uno/gitea_admin/homelab.git`,
+**in-cluster** Gitea (`https://gitea.renner.uno/konairius/homelab.git`,
 `kubernetes/clusters/homelab/flux-system/gotk-sync.yaml`). But that Gitea is
 itself Flux-managed:
 
@@ -37,9 +37,9 @@ entry point.
 **The exit:** bootstrap Flux from the external **GitHub break-glass mirror**
 `github.com/konairius/Homelab` instead of Gitea. That mirror already exists and
 stays current on its own: Gitea has a **native push-mirror** configured on the
-`gitea_admin/homelab` repo (`sync_on_commit=true`, 8h interval fallback), so it
-holds last-good `master` with no cluster involvement — it is server-side inside
-Gitea, so it keeps tracking `master` independent of Woodpecker/agents. Nothing
+`konairius/homelab` repo (`sync_on_commit=true`, 8h interval fallback), so it
+holds last-good `main` with no cluster involvement — it is server-side inside
+Gitea, so it keeps tracking `main` independent of Woodpecker/agents. Nothing
 to set up; just confirm it before relying on it (Prerequisites). Once the
 cluster (and its in-cluster Gitea) is healthy again, switch the Flux source back
 to Gitea (Step 6).
@@ -54,9 +54,9 @@ These must exist outside the cluster or the rebuild cannot complete:
 
 - [ ] **This repo**, checked out locally.
 - [ ] **GitHub mirror is current** — `github.com/konairius/Homelab` at the
-      `master` you intend to restore. Gitea's native push-mirror keeps it there
+      `main` you intend to restore. Gitea's native push-mirror keeps it there
       on every push while Gitea is up; confirm the latest commit matches your
-      intended recovery point (`git ls-remote https://github.com/konairius/Homelab.git master`,
+      intended recovery point (`git ls-remote https://github.com/konairius/Homelab.git main`,
       or the repo's Settings → Mirror Settings last-sync time in Gitea).
 - [ ] **GitHub PAT** for `flux bootstrap github`, exported as `GITHUB_TOKEN`.
       `flux bootstrap` commits its sync manifests into the repo, so this needs
@@ -279,7 +279,7 @@ FLUX_SOURCE=github kubernetes/bootstrap.sh flux
 ```
 
 This runs `flux bootstrap github --owner=konairius --repository=Homelab
---branch=master --path=kubernetes/clusters/homelab --token-auth` (see
+--branch=main --path=kubernetes/clusters/homelab --token-auth` (see
 `bootstrap.sh`). Flux then:
 
 1. installs its controllers + the `sops-age` Secret,
@@ -401,21 +401,21 @@ kubernetes/bootstrap.sh flux        # FLUX_SOURCE defaults to gitea; re-runs
 
 Confirm `kubectl -n flux-system get gitrepository flux-system` again shows the
 `gitea.renner.uno` URL and reconciles. Gitea's push-mirror then resumes tracking
-`master` on the next push automatically — nothing to re-enable.
+`main` on the next push automatically — nothing to re-enable.
 
 ## Mirror maintenance — none required
 
 Keeping the break-glass source current is **already handled by Gitea itself**,
 not by any cluster workload. A native push-mirror is configured on the
-`gitea_admin/homelab` repo (remote `https://github.com/konairius/Homelab.git`,
-`sync_on_commit=true`, 8h interval fallback), so Gitea pushes `master` to GitHub
+`konairius/homelab` repo (remote `https://github.com/konairius/Homelab.git`,
+`sync_on_commit=true`, 8h interval fallback), so Gitea pushes `main` to GitHub
 on every `git receive` for as long as Gitea is up — which is also the only time
-`master` advances. It runs server-side inside Gitea, so it survives Woodpecker /
+`main` advances. It runs server-side inside Gitea, so it survives Woodpecker /
 agent outages, and it predates and survived the in-cluster migration.
 
 There is no setup step and no credential to provision here. To inspect or audit
 it: repo → **Settings → Repository → Mirror Settings** in Gitea, or
-`GET /api/v1/repos/gitea_admin/homelab/push_mirrors` (admin token) — check
+`GET /api/v1/repos/konairius/homelab/push_mirrors` (admin token) — check
 `last_error` is empty and `last_update` is recent.
 
 ## Recovery-point & known gaps

kubernetes/RUNBOOK-home-assistant-image-rollback.md

@@ -2,7 +2,7 @@
 
 Use when an automatic Home Assistant update (a
 `chore(image-automation): bump ghcr.io/home-assistant/home-assistant:<new>`
-commit on `master`) breaks Home Assistant. The owner approves the rollback
+commit on `main`) breaks Home Assistant. The owner approves the rollback
 and its timing. Atlas writes the PR; Argus merges it.
 
 ## Why a plain `git revert` is not enough
@@ -22,7 +22,7 @@ automation.
 
 1. Find the bump commit:
    ```sh
-   git log --oneline -5 origin/master -- kubernetes/apps/home-assistant/deployment.yaml
+   git log --oneline -5 origin/main -- kubernetes/apps/home-assistant/deployment.yaml
    ```
 2. Check the release notes of the broken version for a **database schema**
    change. Home Assistant migrates the recorder schema (CNPG cluster
@@ -35,7 +35,7 @@ automation.
 ## Roll back (one commit, one PR)
 
 ```sh
-git worktree add -b atlas/ha-rollback-<old> "$WT" origin/master && cd "$WT"
+git worktree add -b atlas/ha-rollback-<old> "$WT" origin/main && cd "$WT"
 git revert --no-commit <bump-sha>
 # In kubernetes/apps/home-assistant/deployment.yaml, delete the trailing
 #   # {"$imagepolicy": "flux-system:home-assistant"}

kubernetes/apps/audiobookshelf/kumamonitors.yaml

@@ -0,0 +1,98 @@
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: audiobooks
+  namespace: audiobookshelf
+  labels:
+    uptime.renner.uno/status-page-section: services
+spec:
+  type: group
+  displayName: Audiobooks
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: audiobooks-dns
+  namespace: audiobookshelf
+spec:
+  type: dns
+  displayName: Audiobookshelf DNS
+  parentRef:
+    name: audiobooks
+  interval: 60
+  retryInterval: 60
+  maxRetries: 1
+  dns:
+    # cluster services have no own record; they resolve through the *.renner.uno wildcard
+    hostname: audiobooks.renner.uno
+    resolveType: CNAME
+    resolveServer: "2606:4700:4700::1111,1.1.1.1"
+    conditions:
+      - operator: equals
+        value: proxy.renner.uno
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: audiobooks-http
+  namespace: audiobookshelf
+spec:
+  type: http
+  displayName: Audiobookshelf HTTP
+  parentRef:
+    name: audiobooks
+  interval: 60
+  retryInterval: 60
+  maxRetries: 1
+  timeout: 10
+  http:
+    # reachable: any answer from the backend below 5xx, redirects not followed
+    url: https://audiobooks.renner.uno/
+    acceptedStatusCodes: ["200-499"]
+    maxRedirects: 0
+    expiryNotification: true
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: audiobooks-health
+  namespace: audiobookshelf
+spec:
+  type: keyword
+  displayName: Audiobookshelf Health
+  parentRef:
+    name: audiobooks
+  interval: 60
+  retryInterval: 60
+  maxRetries: 1
+  timeout: 10
+  http:
+    url: https://audiobooks.renner.uno/healthcheck
+    acceptedStatusCodes: ["200-299"]
+    expiryNotification: true
+  keyword:
+    keyword: OK
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: audiobooks-status
+  namespace: audiobookshelf
+spec:
+  type: json-query
+  displayName: Audiobookshelf Server
+  parentRef:
+    name: audiobooks
+  interval: 60
+  retryInterval: 60
+  maxRetries: 1
+  timeout: 10
+  http:
+    # initialized-server flag from the unauthenticated status endpoint
+    url: https://audiobooks.renner.uno/status
+    acceptedStatusCodes: ["200-299"]
+    expiryNotification: true
+  jsonQuery:
+    expression: isInit
+    operator: "=="
+    expected: "true"

kubernetes/apps/audiobookshelf/kustomization.yaml

@@ -4,3 +4,4 @@ resources:
   - pvcs.yaml
   - deployment.yaml
   - ingress.yaml
+  - kumamonitors.yaml

kubernetes/apps/authentik/blueprints-configmap.yaml

@@ -295,8 +295,8 @@ data:
           name: llama-gate
         state: absent
 
-      # Retired: wiki-gate. wiki.renner.uno is gated by authentik-gate-sync
-      # (kubernetes/apps/wiki/ingress.yaml).
+      # Retired: wiki-gate. The wiki signs humans in itself (application
+      # `wiki` in passkey-stepup.yaml).
       - model: authentik_outposts.outpost
         identifiers:
           name: wiki-gate
@@ -1011,6 +1011,7 @@ data:
             - !Find [authentik_providers_oauth2.scopemapping, [managed, goauthentik.io/providers/oauth2/scope-openid]]
             - !Find [authentik_providers_oauth2.scopemapping, [managed, goauthentik.io/providers/oauth2/scope-profile]]
             - !Find [authentik_providers_oauth2.scopemapping, [managed, goauthentik.io/providers/oauth2/scope-email]]
+            - !Find [authentik_providers_oauth2.scopemapping, [managed, goauthentik.io/providers/oauth2/scope-offline_access]]
           redirect_uris:
             - url: https://hermes.renner.uno/auth/callback
               matching_mode: strict
@@ -1039,6 +1040,44 @@ data:
           negate: false
           failure_result: false
 
+      # Wiki (apps/wiki): its own OIDC login. Public client + PKCE; RS256
+      # so the service verifies the ID token against the JWKS. No policy
+      # binding: every Authentik user may sign in.
+      - id: wiki-provider
+        model: authentik_providers_oauth2.oauth2provider
+        identifiers:
+          name: Wiki
+        state: present
+        attrs:
+          authentication_flow: null
+          authorization_flow: !Find [authentik_flows.flow, [slug, default-provider-authorization-implicit-consent]]
+          invalidation_flow: !Find [authentik_flows.flow, [slug, default-provider-invalidation-flow]]
+          client_type: public
+          client_id: wiki
+          # See the Matrix (MAS) provider: a blueprint-made provider starts
+          # with no grant types.
+          grant_types:
+            - authorization_code
+          signing_key: !Find [authentik_crypto.certificatekeypair, [name, authentik Self-signed Certificate]]
+          property_mappings:
+            - !Find [authentik_providers_oauth2.scopemapping, [managed, goauthentik.io/providers/oauth2/scope-openid]]
+            - !Find [authentik_providers_oauth2.scopemapping, [managed, goauthentik.io/providers/oauth2/scope-profile]]
+          redirect_uris:
+            - url: https://wiki.renner.uno/signin-oidc
+              matching_mode: strict
+
+      # The slug is the issuer path: https://auth.renner.uno/application/o/wiki/
+      - model: authentik_core.application
+        identifiers:
+          slug: wiki
+        state: present
+        attrs:
+          name: Wiki
+          slug: wiki
+          provider: !KeyOf wiki-provider
+          meta_launch_url: https://wiki.renner.uno
+          meta_description: "Homelab wiki"
+
       # OpenProject, decommissioned. Application first: Application.provider
       # is on_delete=PROTECT. Its policy binding cascades with it.
       - model: authentik_core.application

kubernetes/apps/authentik/kumamonitors.yaml

@@ -0,0 +1,93 @@
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: auth
+  namespace: authentik
+  labels:
+    uptime.renner.uno/status-page-section: services
+spec:
+  type: group
+  displayName: Authentik
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: auth-dns
+  namespace: authentik
+spec:
+  type: dns
+  displayName: Authentik DNS
+  parentRef:
+    name: auth
+  interval: 60
+  retryInterval: 60
+  maxRetries: 1
+  dns:
+    # cluster services have no own record; they resolve through the *.renner.uno wildcard
+    hostname: auth.renner.uno
+    resolveType: CNAME
+    resolveServer: "2606:4700:4700::1111,1.1.1.1"
+    conditions:
+      - operator: equals
+        value: proxy.renner.uno
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: auth-http
+  namespace: authentik
+spec:
+  type: http
+  displayName: Authentik HTTP
+  parentRef:
+    name: auth
+  interval: 60
+  retryInterval: 60
+  maxRetries: 1
+  timeout: 10
+  http:
+    # reachable: any answer from the backend below 5xx, redirects not followed
+    url: https://auth.renner.uno/
+    acceptedStatusCodes: ["200-499"]
+    maxRedirects: 0
+    expiryNotification: true
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: auth-live
+  namespace: authentik
+spec:
+  type: http
+  displayName: Authentik Live
+  parentRef:
+    name: auth
+  interval: 60
+  retryInterval: 60
+  maxRetries: 1
+  timeout: 10
+  http:
+    # ungated health endpoint, empty body
+    url: https://auth.renner.uno/-/health/live/
+    acceptedStatusCodes: ["200-299"]
+    expiryNotification: true
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: auth-ready
+  namespace: authentik
+spec:
+  type: http
+  displayName: Authentik Ready
+  parentRef:
+    name: auth
+  interval: 60
+  retryInterval: 60
+  maxRetries: 1
+  timeout: 10
+  http:
+    # ungated readiness endpoint (database and cache), empty body
+    url: https://auth.renner.uno/-/health/ready/
+    acceptedStatusCodes: ["200-299"]
+    expiryNotification: true

kubernetes/apps/authentik/kustomization.yaml

@@ -17,3 +17,4 @@ resources:
   - cluster.yaml
   - scheduled-backup.yaml
   - hetzner-creds-externalsecret.yaml
+  - kumamonitors.yaml

kubernetes/apps/gatus/configmap.yaml

@@ -309,7 +309,7 @@ data:
 
       # Mosquitto MQTT broker (ClusterIP, home-assistant ns). A TCP-connect
       # check on :1883: the broker's image tag is auto-bumped by Flux
-      # image-automation straight to master (no CI gate), and the deployment
+      # image-automation straight to main (no CI gate), and the deployment
       # is a single Recreate/rolling pod, so a bad bump that fails to come up
       # would otherwise be silent. This turns that into an alert.
       - name: Infrastructure 4

kubernetes/apps/gatus/kumamonitors.yaml

@@ -0,0 +1,76 @@
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: status
+  namespace: apps
+  labels:
+    uptime.renner.uno/status-page-section: services
+spec:
+  type: group
+  displayName: Status Page
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: status-dns
+  namespace: apps
+spec:
+  type: dns
+  displayName: Gatus DNS
+  parentRef:
+    name: status
+  interval: 60
+  retryInterval: 60
+  maxRetries: 1
+  dns:
+    # cluster services have no own record; they resolve through the *.renner.uno wildcard
+    hostname: status.renner.uno
+    resolveType: CNAME
+    resolveServer: "2606:4700:4700::1111,1.1.1.1"
+    conditions:
+      - operator: equals
+        value: proxy.renner.uno
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: status-http
+  namespace: apps
+spec:
+  type: http
+  displayName: Gatus HTTP
+  parentRef:
+    name: status
+  interval: 60
+  retryInterval: 60
+  maxRetries: 1
+  timeout: 10
+  http:
+    # reachable: any answer from the backend below 5xx, redirects not followed
+    url: https://status.renner.uno/
+    acceptedStatusCodes: ["200-499"]
+    maxRedirects: 0
+    expiryNotification: true
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: status-health
+  namespace: apps
+spec:
+  type: json-query
+  displayName: Gatus Health
+  parentRef:
+    name: status
+  interval: 60
+  retryInterval: 60
+  maxRetries: 1
+  timeout: 10
+  http:
+    url: https://status.renner.uno/health
+    acceptedStatusCodes: ["200-299"]
+    expiryNotification: true
+  jsonQuery:
+    expression: status
+    operator: "=="
+    expected: "UP"

kubernetes/apps/gatus/kustomization.yaml

@@ -6,3 +6,4 @@ resources:
   - service.yaml
   - ingress.yaml
   - pvc.yaml
+  - kumamonitors.yaml

kubernetes/apps/gitea-mcp/kumamonitors.yaml

@@ -0,0 +1,75 @@
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: gitea-mcp
+  namespace: gitea-mcp
+  labels:
+    uptime.renner.uno/status-page-section: services
+spec:
+  type: group
+  displayName: Gitea MCP
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: gitea-mcp-dns
+  namespace: gitea-mcp
+spec:
+  type: dns
+  displayName: Gitea MCP DNS
+  parentRef:
+    name: gitea-mcp
+  interval: 60
+  retryInterval: 60
+  maxRetries: 1
+  dns:
+    # cluster services have no own record; they resolve through the *.renner.uno wildcard
+    hostname: gitea-mcp.renner.uno
+    resolveType: CNAME
+    resolveServer: "2606:4700:4700::1111,1.1.1.1"
+    conditions:
+      - operator: equals
+        value: proxy.renner.uno
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: gitea-mcp-http
+  namespace: gitea-mcp
+spec:
+  type: http
+  displayName: Gitea MCP HTTP
+  parentRef:
+    name: gitea-mcp
+  interval: 60
+  retryInterval: 60
+  maxRetries: 1
+  timeout: 10
+  http:
+    # reachable: any answer from the backend below 5xx, redirects not followed
+    url: https://gitea-mcp.renner.uno/healthz
+    acceptedStatusCodes: ["200-499"]
+    maxRedirects: 0
+    expiryNotification: true
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: gitea-mcp-auth
+  namespace: gitea-mcp
+spec:
+  type: keyword
+  displayName: Gitea MCP Endpoint
+  parentRef:
+    name: gitea-mcp
+  interval: 60
+  retryInterval: 60
+  maxRetries: 1
+  timeout: 10
+  http:
+    # MCP endpoint answers and refuses unauthenticated calls
+    url: https://gitea-mcp.renner.uno/mcp
+    acceptedStatusCodes: ["401"]
+    expiryNotification: true
+  keyword:
+    keyword: authorization required

kubernetes/apps/gitea-mcp/kustomization.yaml

@@ -4,3 +4,4 @@ resources:
   - deployment.yaml
   - service.yaml
   - ingress.yaml
+  - kumamonitors.yaml

kubernetes/apps/gitea/kumamonitors.yaml

@@ -0,0 +1,144 @@
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: gitea
+  namespace: gitea
+  labels:
+    uptime.renner.uno/status-page-section: services
+spec:
+  type: group
+  displayName: Gitea
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: git-dns
+  namespace: gitea
+spec:
+  type: dns
+  displayName: git.renner.uno DNS
+  parentRef:
+    name: gitea
+  interval: 60
+  retryInterval: 60
+  maxRetries: 1
+  dns:
+    # cluster services have no own record; they resolve through the *.renner.uno wildcard
+    hostname: git.renner.uno
+    resolveType: CNAME
+    resolveServer: "2606:4700:4700::1111,1.1.1.1"
+    conditions:
+      - operator: equals
+        value: proxy.renner.uno
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: git-http
+  namespace: gitea
+spec:
+  type: http
+  displayName: git.renner.uno HTTP
+  parentRef:
+    name: gitea
+  interval: 60
+  retryInterval: 60
+  maxRetries: 1
+  timeout: 10
+  http:
+    # reachable: any answer from the backend below 5xx, redirects not followed
+    url: https://git.renner.uno/
+    acceptedStatusCodes: ["200-499"]
+    maxRedirects: 0
+    expiryNotification: true
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: git-health
+  namespace: gitea
+spec:
+  type: json-query
+  displayName: git.renner.uno Health
+  parentRef:
+    name: gitea
+  interval: 60
+  retryInterval: 60
+  maxRetries: 1
+  timeout: 10
+  http:
+    # ungated health endpoint (database and cache)
+    url: https://git.renner.uno/api/healthz
+    acceptedStatusCodes: ["200-299"]
+    expiryNotification: true
+  jsonQuery:
+    expression: status
+    operator: "=="
+    expected: "pass"
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: gitea-dns
+  namespace: gitea
+spec:
+  type: dns
+  displayName: gitea.renner.uno DNS
+  parentRef:
+    name: gitea
+  interval: 60
+  retryInterval: 60
+  maxRetries: 1
+  dns:
+    # cluster services have no own record; they resolve through the *.renner.uno wildcard
+    hostname: gitea.renner.uno
+    resolveType: CNAME
+    resolveServer: "2606:4700:4700::1111,1.1.1.1"
+    conditions:
+      - operator: equals
+        value: proxy.renner.uno
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: gitea-http
+  namespace: gitea
+spec:
+  type: http
+  displayName: gitea.renner.uno HTTP
+  parentRef:
+    name: gitea
+  interval: 60
+  retryInterval: 60
+  maxRetries: 1
+  timeout: 10
+  http:
+    # reachable: any answer from the backend below 5xx, redirects not followed
+    url: https://gitea.renner.uno/
+    acceptedStatusCodes: ["200-499"]
+    maxRedirects: 0
+    expiryNotification: true
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: gitea-health
+  namespace: gitea
+spec:
+  type: json-query
+  displayName: gitea.renner.uno Health
+  parentRef:
+    name: gitea
+  interval: 60
+  retryInterval: 60
+  maxRetries: 1
+  timeout: 10
+  http:
+    # ungated health endpoint (database and cache)
+    url: https://gitea.renner.uno/api/healthz
+    acceptedStatusCodes: ["200-299"]
+    expiryNotification: true
+  jsonQuery:
+    expression: status
+    operator: "=="
+    expected: "pass"

kubernetes/apps/gitea/kustomization.yaml

@@ -16,6 +16,7 @@ resources:
   - networkpolicy.yaml
   # Nightly prune of old CI image builds (REN-1203).
   - package-retention.yaml
+  - kumamonitors.yaml
 configMapGenerator:
   - name: gitea-package-retention
     namespace: gitea

kubernetes/apps/hermes/SOUL.md

@@ -5,11 +5,14 @@ When you use a pronoun for someone whose pronouns haven't been stated, use they/
 # What you can touch
 
 - `kubectl`: read-only cluster access (the `view` ClusterRole, no Secrets). You cannot change the cluster.
+- `talosctl`: read-only (`os:reader`) on the Talos nodes; `TALOSCONFIG` is set, the endpoint is `talos.default`. Pass nodes by name with `-n` (e.g. `talosctl -n k8s-1 get members`, `-n k8s-1,k8s-2,k8s-3`).
+- `bao`: OpenBao at `BAO_ADDR`, read-only on your own `homelab/apps/hermes/*`. Log in per command, never store the token: `export VAULT_TOKEN=$(bao write -field=token auth/kubernetes/login role=hermes jwt=@/var/run/secrets/kubernetes.io/serviceaccount/token)` then e.g. `bao kv list -mount=homelab apps/hermes`. Never print secret values.
 - Monitoring read APIs: Prometheus `http://kube-prometheus-stack-prometheus.monitoring.svc:9090`, Alertmanager `http://kube-prometheus-stack-alertmanager.monitoring.svc:9093`, Loki `http://loki.monitoring.svc:3100`.
 - The homelab wiki through the `homelab-wiki` skill (read, and deposit facts).
+- Home Assistant (`https://home.renner.uno`) as your own admin user, only through the `ha-updates` skill: read state and health, install HACS and device-firmware updates and restart HA, inside 02:00-05:00 Europe/Berlin only (owner decision). No other HA changes.
 - The web (HTTPS) and LAN hostnames under `renner.uno` through Traefik.
 
-- Gitea (`https://gitea.renner.uno`) as `hermes-bot`: `git` over HTTPS authenticates and sets the commit identity on its own. For the API, send `Authorization: token <contents of /var/run/secrets/gitea/api-token>` (read it inside the command, never print it). `tea` is installed but not logged in; use the REST API (`/api/v1`). You write only to repos where `hermes-bot` is a collaborator.
+- Gitea (`https://gitea.renner.uno`) as `hermes-bot`: `git` over HTTPS authenticates and sets the commit identity on its own. For the API, send `Authorization: token <contents of /var/run/secrets/gitea/api-token>` (read it inside the command, never print it). `tea` is logged in as `hermes-bot` (login `hermes-bot`, the default). You write only to repos where `hermes-bot` is a collaborator.
 
 All state of record lives in git: infrastructure in the `homelab` repo (Kubernetes/Flux, Ansible, OpenTofu, ESPHome), Home Assistant config in the `homeassistant` repo. Changes land as a feature branch plus a PR for the owner's review (see below).
 

kubernetes/apps/hermes/hermes.yaml

@@ -71,6 +71,30 @@ spec:
           volumeMounts:
             - name: data
               mountPath: /opt/data
+        # WebSocket keepalive ping interval in seconds (default 20).
+        - name: config-ws-ping
+          image: gitea.renner.uno/konairius/hermes:build.1792397861 # {"$imagepolicy": "flux-system:hermes"}
+          command:
+            - /opt/hermes/.venv/bin/hermes
+            - config
+            - set
+            - dashboard.ws_ping_interval
+            - "60"
+          env:
+            - name: HERMES_HOME
+              value: /opt/data
+            - name: HOME
+              value: /opt/data
+          securityContext:
+            runAsUser: 10000
+            runAsGroup: 10000
+            runAsNonRoot: true
+            allowPrivilegeEscalation: false
+            capabilities:
+              drop: ["ALL"]
+          volumeMounts:
+            - name: data
+              mountPath: /opt/data
         # Skills from git (ConfigMap hermes-skills) beside the PVC's skills/.
         - name: skills-config
           image: gitea.renner.uno/konairius/hermes:build.1792397861 # {"$imagepolicy": "flux-system:hermes"}
@@ -95,6 +119,75 @@ spec:
           volumeMounts:
             - name: data
               mountPath: /opt/data
+        # Cron job ha-updates (skill ha-updates), created or updated in place on
+        # every start. Hermes cron runs in UTC: 01:00/05:00/... UTC puts one run
+        # at 02:00 CET / 03:00 CEST, inside the 02:00-05:00 Berlin window.
+        - name: cron-ha-updates
+          image: gitea.renner.uno/konairius/hermes:build.1792397861 # {"$imagepolicy": "flux-system:hermes"}
+          command:
+            - sh
+            - -ec
+            - |
+              H=/opt/hermes/.venv/bin/hermes
+              PROMPT='Run the ha-updates skill: check Home Assistant updates, apply the safe ones only inside the 02:00-05:00 Europe/Berlin window, report per the skill, or answer [SILENT].'
+              id=$(/opt/hermes/.venv/bin/python -c '
+              import json
+              try:
+                  jobs = json.load(open("/opt/data/cron/jobs.json"))["jobs"]
+              except FileNotFoundError:
+                  jobs = []
+              print(next((j["id"] for j in jobs if j.get("name") == "ha-updates"), ""))')
+              set -- --deliver matrix --skill ha-updates --skill homelab-wiki --continuity
+              if [ -n "$id" ]; then
+                "$H" cron edit "$id" --schedule '0 1,5,9,13,17,21 * * *' --prompt "$PROMPT" "$@"
+              else
+                "$H" cron create --name ha-updates "$@" '0 1,5,9,13,17,21 * * *' "$PROMPT"
+              fi
+          env:
+            - name: HERMES_HOME
+              value: /opt/data
+            - name: HOME
+              value: /opt/data
+          securityContext:
+            runAsUser: 10000
+            runAsGroup: 10000
+            runAsNonRoot: true
+            allowPrivilegeEscalation: false
+            capabilities:
+              drop: ["ALL"]
+          volumeMounts:
+            - name: data
+              mountPath: /opt/data
+        # tea login hermes-bot, written from the mounted token into an
+        # emptyDir at the agent's ~/.config/tea.
+        - name: tea-login
+          image: gitea.renner.uno/konairius/hermes:build.1792397861 # {"$imagepolicy": "flux-system:hermes"}
+          command:
+            - sh
+            - -ec
+            - |
+              umask 077
+              {
+                echo 'logins:'
+                echo '  - name: hermes-bot'
+                echo '    url: https://gitea.renner.uno'
+                echo "    token: $(cat /var/run/secrets/gitea/api-token)"
+                echo '    default: true'
+                echo '    user: hermes-bot'
+              } > /tea/config.yml
+          securityContext:
+            runAsUser: 10000
+            runAsGroup: 10000
+            runAsNonRoot: true
+            allowPrivilegeEscalation: false
+            capabilities:
+              drop: ["ALL"]
+          volumeMounts:
+            - name: tea-config
+              mountPath: /tea
+            - name: gitea-token
+              mountPath: /var/run/secrets/gitea
+              readOnly: true
       containers:
         - name: hermes
           image: gitea.renner.uno/konairius/hermes:build.1792397861 # {"$imagepolicy": "flux-system:hermes"}
@@ -110,10 +203,34 @@ spec:
               value: https://auth.renner.uno/application/o/hermes/
             - name: HERMES_DASHBOARD_OIDC_CLIENT_ID
               value: hermes-dashboard
+            # offline_access: Authentik issues a refresh token only when requested.
+            - name: HERMES_DASHBOARD_OIDC_SCOPES
+              value: openid profile email offline_access
             - name: API_SERVER_ENABLED
               value: "true"
             - name: API_SERVER_HOST
               value: 0.0.0.0
+            # Matrix: bot @hermes (MAS account, compatibility token on device
+            # HERMESBOT in hermes-matrix); E2EE store under /opt/data/platforms/matrix.
+            - name: MATRIX_HOMESERVER
+              value: https://matrix.renner.uno
+            - name: MATRIX_USER_ID
+              value: "@hermes:matrix.renner.uno"
+            - name: MATRIX_ALLOWED_USERS
+              value: "@k.renner:matrix.renner.uno"
+            - name: MATRIX_E2EE_MODE
+              value: required
+            # One-time cross-signing bootstrap writes the generated recovery key here (0600).
+            - name: MATRIX_RECOVERY_KEY_OUTPUT_FILE
+              value: /opt/data/platforms/matrix/recovery-key.txt
+            # bao: log in with the pod's ServiceAccount token, role hermes
+            # (kubernetes/infrastructure/openbao/policies/hermes.hcl).
+            - name: BAO_ADDR
+              value: http://openbao.openbao.svc.cluster.local:8200
+            # talosctl: os:reader talosconfig from the talos.dev ServiceAccount
+            # hermes-talos (talos-serviceaccount.yaml).
+            - name: TALOSCONFIG
+              value: /var/run/secrets/talos.dev/config
             # git as hermes-bot: the credential helper reads the mounted token.
             - name: GIT_CONFIG_COUNT
               value: "3"
@@ -132,6 +249,8 @@ spec:
           envFrom:
             - secretRef:
                 name: hermes-api-key
+            - secretRef:
+                name: hermes-matrix
           ports:
             - name: dashboard
               containerPort: 9119
@@ -179,6 +298,14 @@ spec:
             - name: gitea-token
               mountPath: /var/run/secrets/gitea
               readOnly: true
+            - name: tea-config
+              mountPath: /opt/data/home/.config/tea
+            - name: talos-config
+              mountPath: /var/run/secrets/talos.dev
+              readOnly: true
+            - name: homeassistant-token
+              mountPath: /var/run/secrets/homeassistant
+              readOnly: true
       volumes:
         - name: data
           persistentVolumeClaim:
@@ -194,6 +321,10 @@ spec:
                 path: homelab-wiki/SKILL.md
               - key: homelab-wiki-wiki.py
                 path: homelab-wiki/scripts/wiki.py
+              - key: ha-updates-SKILL.md
+                path: ha-updates/SKILL.md
+              - key: ha-updates-ha.py
+                path: ha-updates/scripts/ha.py
         - name: wiki-key
           secret:
             secretName: hermes-wiki
@@ -201,6 +332,15 @@ spec:
         - name: gitea-token
           secret:
             secretName: hermes-gitea
+        - name: tea-config
+          emptyDir: {}
+        - name: talos-config
+          secret:
+            secretName: hermes-talos
+            optional: true
+        - name: homeassistant-token
+          secret:
+            secretName: hermes-homeassistant
 ---
 apiVersion: v1
 kind: Service

kubernetes/apps/hermes/homeassistant-externalsecret.yaml

@@ -0,0 +1,18 @@
+# Long-lived access token of Hermes's own Home Assistant admin user (ha-updates skill).
+apiVersion: external-secrets.io/v1
+kind: ExternalSecret
+metadata:
+  name: hermes-homeassistant
+  namespace: hermes
+spec:
+  refreshInterval: 1h
+  secretStoreRef:
+    kind: ClusterSecretStore
+    name: openbao
+  target:
+    name: hermes-homeassistant
+  data:
+    - secretKey: token
+      remoteRef:
+        key: apps/hermes/homeassistant
+        property: token

kubernetes/apps/hermes/kustomization.yaml

@@ -5,6 +5,9 @@ resources:
   - api-key.yaml
   - wiki-externalsecret.yaml
   - gitea-externalsecret.yaml
+  - matrix-externalsecret.yaml
+  - homeassistant-externalsecret.yaml
+  - talos-serviceaccount.yaml
   - hermes.yaml
   - ingress.yaml
 configMapGenerator:
@@ -17,3 +20,5 @@ configMapGenerator:
     files:
       - homelab-wiki-SKILL.md=skills/homelab-wiki/SKILL.md
       - homelab-wiki-wiki.py=skills/homelab-wiki/scripts/wiki.py
+      - ha-updates-SKILL.md=skills/ha-updates/SKILL.md
+      - ha-updates-ha.py=skills/ha-updates/scripts/ha.py

kubernetes/apps/hermes/matrix-externalsecret.yaml

@@ -0,0 +1,18 @@
+# Access token of @hermes:matrix.renner.uno (MAS compatibility token, device HERMESBOT).
+apiVersion: external-secrets.io/v1
+kind: ExternalSecret
+metadata:
+  name: hermes-matrix
+  namespace: hermes
+spec:
+  refreshInterval: 1h
+  secretStoreRef:
+    kind: ClusterSecretStore
+    name: openbao
+  target:
+    name: hermes-matrix
+  data:
+    - secretKey: MATRIX_ACCESS_TOKEN
+      remoteRef:
+        key: apps/hermes/matrix
+        property: access_token

kubernetes/apps/hermes/skills/ha-updates/SKILL.md

@@ -0,0 +1,113 @@
+---
+name: ha-updates
+description: Check Home Assistant update entities (HACS integrations/cards, device firmware), vet each update against release notes and our config, apply the safe ones inside the 02:00-05:00 Europe/Berlin window, verify HA health before/after and roll back regressions. Used by the ha-updates cron job; reports to Matrix.
+version: 1.0.0
+metadata:
+  hermes:
+    tags: [homelab, home-assistant, updates, cron]
+    category: devops
+---
+
+# Home Assistant updates
+
+Owner decision: HACS updates and device firmware that Home Assistant offers as
+`update.*` entities are applied automatically, inside 02:00-05:00
+Europe/Berlin only (README "Change rules that protect Home Assistant"). Outside
+the window this job only checks and reports. Matrix gets a message when
+something was applied or a problem was found; otherwise the run is silent.
+
+Out of scope, never install: Home Assistant core (Flux image automation owns
+it), anything with `can_install: false`, and updates the owner skipped.
+
+Held by owner decision (report once per version as `held: owner`, never
+install): integration `unifi` (switches, APs, the UDM) and integration
+`smlight` (SLZB Zigbee coordinators).
+
+Talk to HA only through the client (stdlib, reads the token itself, never print it):
+
+```
+python3 /opt/hermes-skills/ha-updates/scripts/ha.py window                 # in_window, minutes_left
+python3 /opt/hermes-skills/ha-updates/scripts/ha.py updates                # pending update entities
+python3 /opt/hermes-skills/ha-updates/scripts/ha.py snapshot <name>        # health -> /opt/data/ha-updates/<name>.json
+python3 /opt/hermes-skills/ha-updates/scripts/ha.py compare <before> <after>   # exit 1 + problems on regression
+python3 /opt/hermes-skills/ha-updates/scripts/ha.py install <entity_id> [--version V]   # waits until settled
+python3 /opt/hermes-skills/ha-updates/scripts/ha.py restart                # restart, wait for RUNNING
+```
+
+A snapshot holds: reachable/core state, version, safe mode, loaded component
+count, `check_config` result, unavailable entity ids, and masked ERROR/CRITICAL
+log signatures of the current HA session.
+
+## Every run
+
+1. `window`, then `updates`. HA unreachable or HTTP 401/403 is a problem:
+   report it and stop.
+2. Vet each pending update once per target version (your previous run's output
+   is in the prompt; don't redo a verdict it already gave):
+   - Ask the wiki (`homelab-wiki`) whether another tool owns that fleet's
+     firmware or that component (e.g. shelly-manager for Shelly). If it does,
+     verdict `held: owned by <tool>`.
+   - Read the release notes for every version between `installed` and
+     `latest` (`release_url`, `release_summary`; for HACS the GitHub releases
+     of the repository). Look for breaking changes, removed/renamed options or
+     entities, a minimum HA version above ours (`snapshot` → `version`),
+     required migrations or re-pairing.
+   - Check the breaking items against our config: read-only clone of
+     `https://gitea.renner.uno/konairius/homeassistant` (git authenticates as
+     hermes-bot). Grep for the integration, its options and entity ids.
+   - Verdict: `safe`, `risky: <why>` (needs the owner; never applied by this
+     job), or `held: <why>`.
+3. Outside the window: if there is no problem and no pending update that your
+   previous output did not already report, answer exactly `[SILENT]`.
+   Otherwise report the new updates with verdicts and say that `safe` ones go
+   in at the next window.
+4. Inside the window: apply (below), then report.
+
+## Applying (inside the window only)
+
+Re-check `window` before every install; start no install with
+`minutes_left` < 30 and no HA restart with `minutes_left` < 20. Leftovers wait
+for the next window.
+
+1. `snapshot pre`. If HA is not RUNNING, is in safe mode, or `check_config` is
+   not `valid`, apply nothing and report the problem.
+2. Firmware (`safe` only), one device at a time:
+   `install <entity>`, wait ~2 min, `snapshot fw`, `compare pre fw`. A
+   regression whose newly unavailable entities or new errors belong to that
+   device or integration stops further firmware installs for that
+   integration; report it (firmware cannot be rolled back). A `timeout` on a
+   battery Zigbee device is not an HA problem: report it, move on.
+3. HACS (`safe` only): note each item's `installed` version, `install` each,
+   then `snapshot pre-restart`. If `check_config` is no longer `valid`, roll
+   every item back (`install <entity> --version <old>`) and do not restart.
+   Otherwise `restart`, wait 3 minutes for integrations to settle,
+   `snapshot post`, `compare pre post`.
+4. On a regression after the restart, wait 5 more minutes and compare a fresh
+   snapshot (startup noise clears). Still regressed: attribute it by logger
+   (`custom_components.<name>`) and entity ids, roll the responsible item(s)
+   back with `--version <old>`, `restart`, and compare again. Not attributable:
+   do not roll back blindly; report with the evidence.
+5. Deposit a wiki fact for any verified breakage (which version broke what, how
+   it was rolled back).
+
+## Report (Matrix)
+
+Terse, no preamble:
+
+```
+HA updates <date> <applied in window | check>
+Applied: <title> <old> → <new>, ...
+Rolled back: <title> <new> → <old> (<reason>)
+Problems: <what, evidence>
+Waiting for owner: <title> <latest> (<risk>)
+Held: <title> (<why>)
+```
+
+Leave out empty sections. Nothing applied and no problems: `[SILENT]`.
+
+## Never
+
+- install or restart outside the window, or install HA core;
+- apply a `risky` update, or skip (`update.skip`) one without the owner;
+- change git or the cluster: this job only drives HA's update entities;
+- print the token, or paste secrets from logs into Matrix.

kubernetes/apps/hermes/skills/ha-updates/scripts/ha.py

@@ -0,0 +1,286 @@
+#!/usr/bin/env python3
+"""Home Assistant client for the ha-updates skill (REST API, bearer token).
+
+  ha.py window                       is now inside 02:00-05:00 Europe/Berlin?
+  ha.py updates [--all]              update entities (pending only unless --all)
+  ha.py snapshot <name>              health snapshot -> $HA_STATE_DIR/<name>.json
+  ha.py compare <before> <after>     regressions between two snapshots (exit 1 if any)
+  ha.py install <entity_id> [--version V] [--timeout S]
+                                     install and wait until the entity settles
+  ha.py restart [--timeout S]        restart HA and wait until it is RUNNING again
+"""
+import argparse
+import datetime
+import json
+import os
+import re
+import sys
+import time
+import urllib.error
+import urllib.request
+from zoneinfo import ZoneInfo
+
+URL = os.environ.get("HA_URL", "https://home.renner.uno").rstrip("/")
+TOKEN_FILE = os.environ.get("HA_TOKEN_FILE", "/var/run/secrets/homeassistant/token")
+STATE_DIR = os.environ.get("HA_STATE_DIR", "/opt/data/ha-updates")
+BERLIN = ZoneInfo("Europe/Berlin")
+WINDOW = (2, 5)  # hours, Europe/Berlin, start inclusive, end exclusive
+
+# update entity supported_features bits (homeassistant.components.update.UpdateEntityFeature)
+INSTALL, SPECIFIC_VERSION, PROGRESS, BACKUP, RELEASE_NOTES = 1, 2, 4, 8, 16
+
+
+def token():
+    try:
+        return open(TOKEN_FILE).read().strip()
+    except OSError as e:
+        sys.exit(f"ha: cannot read token file {TOKEN_FILE}: {e.strerror}")
+
+
+def call(method, path, body=None, timeout=60, raw=False):
+    headers = {"Authorization": "Bearer " + token(), "Accept": "application/json"}
+    data = None
+    if body is not None:
+        data = json.dumps(body).encode()
+        headers["Content-Type"] = "application/json"
+    req = urllib.request.Request(URL + path, data=data, headers=headers, method=method)
+    try:
+        with urllib.request.urlopen(req, timeout=timeout) as resp:
+            text = resp.read().decode(errors="replace")
+    except urllib.error.HTTPError as e:
+        sys.exit(f"ha: {method} {path}: HTTP {e.code}\n{e.read().decode(errors='replace')[:2000]}")
+    return text if raw else json.loads(text)
+
+
+def reachable():
+    """(True, core_state) when the API answers, (False, reason) otherwise."""
+    try:
+        return True, call("GET", "/api/core/state", timeout=10).get("state")
+    except SystemExit as e:
+        return False, str(e)
+    except (urllib.error.URLError, OSError, ValueError) as e:
+        return False, str(e)
+
+
+def domains():
+    """entity_id -> integration domain for every update entity."""
+    tpl = (
+        "[{% for s in states.update %}{% set e = config_entry_id(s.entity_id) %}"
+        "[{{ s.entity_id | tojson }}, {{ (config_entry_attr(e, 'domain') if e else none) | tojson }}]"
+        "{% if not loop.last %},{% endif %}{% endfor %}]"
+    )
+    return dict(json.loads(call("POST", "/api/template", {"template": tpl}, raw=True)))
+
+
+def describe(s, dom):
+    a = s["attributes"]
+    f = a.get("supported_features") or 0
+    return {
+        "entity_id": s["entity_id"],
+        "title": a.get("title") or a.get("friendly_name"),
+        "integration": dom.get(s["entity_id"]),
+        "state": s["state"],
+        "installed": a.get("installed_version"),
+        "latest": a.get("latest_version"),
+        "skipped": a.get("skipped_version"),
+        "in_progress": a.get("in_progress"),
+        "can_install": bool(f & INSTALL),
+        "can_pick_version": bool(f & SPECIFIC_VERSION),
+        "release_url": a.get("release_url"),
+        "release_summary": (a.get("release_summary") or "")[:500] or None,
+    }
+
+
+def cmd_window(_):
+    now = datetime.datetime.now(BERLIN)
+    start = now.replace(hour=WINDOW[0], minute=0, second=0, microsecond=0)
+    end = now.replace(hour=WINDOW[1], minute=0, second=0, microsecond=0)
+    inside = start <= now < end
+    print(json.dumps({
+        "now_berlin": now.isoformat(timespec="minutes"),
+        "in_window": inside,
+        "minutes_left": int((end - now).total_seconds() // 60) if inside else 0,
+    }))
+
+
+def cmd_updates(a):
+    dom = domains()
+    out = []
+    for s in call("GET", "/api/states"):
+        if not s["entity_id"].startswith("update."):
+            continue
+        d = describe(s, dom)
+        if a.all or d["state"] == "on" or d["in_progress"]:
+            out.append(d)
+    out.sort(key=lambda d: (d["integration"] or "", d["entity_id"]))
+    print(json.dumps(out, indent=2, ensure_ascii=False))
+
+
+LOG_LINE = re.compile(r"^\S+ \S+ (ERROR|CRITICAL) \([^)]*\) \[([^\]]+)\] (.*)$")
+
+
+def error_signatures(log):
+    """Error/critical log lines with volatile parts (numbers, hex, quoted values) masked."""
+    sigs = set()
+    for line in log.splitlines():
+        m = LOG_LINE.match(line)
+        if m:
+            msg = re.sub(r"0x[0-9a-f]+|\d+(\.\d+)?|'[^']*'|\"[^\"]*\"", "#", m.group(3))[:300]
+            sigs.add(f"{m.group(1)} [{m.group(2)}] {msg}")
+    return sorted(sigs)
+
+
+def snapshot():
+    ok, state = reachable()
+    snap = {"taken": datetime.datetime.now(BERLIN).isoformat(timespec="seconds"), "reachable": ok, "core_state": state}
+    if not ok:
+        return snap
+    cfg = call("GET", "/api/config")
+    snap["version"] = cfg.get("version")
+    snap["safe_mode"] = bool(cfg.get("safe_mode") or cfg.get("recovery_mode"))
+    snap["components"] = len(cfg.get("components") or [])
+    chk = call("POST", "/api/config/core/check_config", timeout=180)
+    snap["config_check"] = {"result": chk.get("result"), "errors": chk.get("errors")}
+    states = call("GET", "/api/states")
+    snap["unavailable"] = sorted(s["entity_id"] for s in states if s["state"] == "unavailable")
+    snap["errors"] = error_signatures(call("GET", "/api/error_log", raw=True, timeout=60))
+    return snap
+
+
+def cmd_snapshot(a):
+    os.makedirs(STATE_DIR, exist_ok=True)
+    snap = snapshot()
+    with open(os.path.join(STATE_DIR, a.name + ".json"), "w") as f:
+        json.dump(snap, f, indent=2)
+    summary = {k: v for k, v in snap.items() if k not in ("unavailable", "errors")}
+    summary["unavailable_count"] = len(snap.get("unavailable", []))
+    summary["error_signatures"] = len(snap.get("errors", []))
+    print(json.dumps(summary, indent=2))
+
+
+def load(name):
+    with open(os.path.join(STATE_DIR, name + ".json")) as f:
+        return json.load(f)
+
+
+def cmd_compare(a):
+    b, c = load(a.before), load(a.after)
+    problems = []
+    if not c.get("reachable") or c.get("core_state") != "RUNNING":
+        problems.append(f"HA not running: reachable={c.get('reachable')} core_state={c.get('core_state')}")
+    if c.get("safe_mode") and not b.get("safe_mode"):
+        problems.append("HA came up in safe/recovery mode")
+    if (c.get("config_check") or {}).get("result") != "valid" and (b.get("config_check") or {}).get("result") == "valid":
+        problems.append(f"config check now invalid: {(c.get('config_check') or {}).get('errors')}")
+    if b.get("components") and c.get("components", 0) < b["components"]:
+        problems.append(f"loaded components dropped {b['components']} -> {c.get('components')}")
+    new_unavail = sorted(set(c.get("unavailable", [])) - set(b.get("unavailable", [])))
+    recovered = sorted(set(b.get("unavailable", [])) - set(c.get("unavailable", [])))
+    new_errors = sorted(set(c.get("errors", [])) - set(b.get("errors", [])))
+    if new_unavail:
+        problems.append(f"{len(new_unavail)} entities newly unavailable")
+    if new_errors:
+        problems.append(f"{len(new_errors)} new error signatures in the HA log")
+    print(json.dumps({
+        "problems": problems,
+        "newly_unavailable": new_unavail,
+        "recovered": recovered,
+        "new_errors": new_errors,
+        "version": [b.get("version"), c.get("version")],
+    }, indent=2, ensure_ascii=False))
+    sys.exit(1 if problems else 0)
+
+
+def entity(entity_id):
+    return call("GET", "/api/states/" + entity_id)
+
+
+def cmd_install(a):
+    before = entity(a.entity_id)
+    attrs = before["attributes"]
+    if not (attrs.get("supported_features") or 0) & INSTALL:
+        sys.exit(f"ha: {a.entity_id} does not support install")
+    body = {"entity_id": a.entity_id}
+    if a.version:
+        body["version"] = a.version
+    target = a.version or attrs.get("latest_version")
+    started = time.time()
+    try:
+        # The action call returns once the install finished; long OTA runs outlive it.
+        call("POST", "/api/services/update/install", body, timeout=a.timeout)
+    except (urllib.error.URLError, OSError) as e:
+        print(f"ha: install call returned early ({e}); polling the entity", file=sys.stderr)
+    idle = 0
+    while True:
+        s = entity(a.entity_id)["attributes"]
+        if not s.get("in_progress") and s.get("installed_version") == target:
+            result = "installed"
+            break
+        if time.time() - started > a.timeout:
+            result = "timeout"
+            break
+        idle = 0 if s.get("in_progress") else idle + 1
+        if idle >= 8:
+            result = "failed"  # idle for 2 minutes and not on the target version
+            break
+        time.sleep(15)
+    print(json.dumps({
+        "entity_id": a.entity_id,
+        "result": result,
+        "from": attrs.get("installed_version"),
+        "target": target,
+        "now": s.get("installed_version"),
+        "seconds": int(time.time() - started),
+    }))
+    sys.exit(0 if result == "installed" else 1)
+
+
+def cmd_restart(a):
+    try:
+        call("POST", "/api/services/homeassistant/restart", {}, timeout=30)
+    except (urllib.error.URLError, OSError):
+        pass  # the connection may drop as HA goes down
+    started, went_down, state = time.time(), False, None
+    while time.time() - started < a.timeout:
+        ok, state = reachable()
+        if not ok or state != "RUNNING":
+            went_down = True
+        elif went_down or time.time() - started > 120:
+            # RUNNING again (or the restart was too fast to observe)
+            print(json.dumps({"result": "running", "observed_down": went_down, "seconds": int(time.time() - started)}))
+            return
+        time.sleep(5)
+    print(json.dumps({"result": "timeout", "observed_down": went_down, "last_state": state}))
+    sys.exit(1)
+
+
+def main():
+    p = argparse.ArgumentParser(prog="ha.py")
+    sub = p.add_subparsers(dest="cmd", required=True)
+    sub.add_parser("window")
+    u = sub.add_parser("updates")
+    u.add_argument("--all", action="store_true")
+    s = sub.add_parser("snapshot")
+    s.add_argument("name")
+    c = sub.add_parser("compare")
+    c.add_argument("before")
+    c.add_argument("after")
+    i = sub.add_parser("install")
+    i.add_argument("entity_id")
+    i.add_argument("--version")
+    i.add_argument("--timeout", type=int, default=3600)
+    r = sub.add_parser("restart")
+    r.add_argument("--timeout", type=int, default=900)
+    a = p.parse_args()
+    {
+        "window": cmd_window,
+        "updates": cmd_updates,
+        "snapshot": cmd_snapshot,
+        "compare": cmd_compare,
+        "install": cmd_install,
+        "restart": cmd_restart,
+    }[a.cmd](a)
+
+
+if __name__ == "__main__":
+    main()

kubernetes/apps/hermes/talos-serviceaccount.yaml

@@ -0,0 +1,12 @@
+# Talos issues an os:reader talosconfig into Secret hermes-talos (key
+# `config`, endpoint talos.default:50000). Needs
+# machine.features.kubernetesTalosAPIAccess on the control planes
+# (kubernetes/talos/patches/cluster.yaml).
+apiVersion: talos.dev/v1alpha1
+kind: ServiceAccount
+metadata:
+  name: hermes-talos
+  namespace: hermes
+spec:
+  roles:
+    - os:reader

kubernetes/apps/home-assistant/deployment.yaml

@@ -93,6 +93,39 @@ spec:
               memory: 16Mi
             limits:
               memory: 32Mi
+        # `matrix_nabu_password` for the Matrix integration's bot @nabu
+        # (homeassistant repo packages/matrix_assist.yaml), same filter-then-append
+        # render as recorder_db_url above. Value is hex, nothing to escape.
+        - name: render-matrix-password
+          image: busybox:1.38@sha256:fd7dc98638c8e305f4dc34e979f1c0fdfdcaeb0fbf8fcff77ae834b6da3d7e6e
+          command:
+            - sh
+            - -c
+            - |
+              set -eu
+              S=/config/secrets.yaml
+              T=/config/.secrets.render.tmp
+              [ -f "$S" ] || : > "$S"
+              grep -v '^matrix_nabu_password:' "$S" > "$T" || true
+              printf 'matrix_nabu_password: "%s"\n' "$NABU_PASSWORD" >> "$T"
+              [ "$(wc -l < "$T")" -ge "$(wc -l < "$S")" ] || {
+                echo "FATAL: rewrite would shrink secrets.yaml; aborting" >&2; exit 1; }
+              chmod 600 "$T"
+              mv "$T" "$S"
+              echo "matrix_nabu_password rendered"
+          env:
+            - name: NABU_PASSWORD
+              valueFrom:
+                secretKeyRef: {name: ha-matrix, key: nabu_password}
+          volumeMounts:
+            - name: config
+              mountPath: /config
+          resources:
+            requests:
+              cpu: 10m
+              memory: 16Mi
+            limits:
+              memory: 32Mi
       containers:
         - name: home-assistant
           image: ghcr.io/home-assistant/home-assistant:2026.10.2 # {"$imagepolicy": "flux-system:home-assistant"}

kubernetes/apps/home-assistant/kumamonitors.yaml

@@ -0,0 +1,98 @@
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: home
+  namespace: home-assistant
+  labels:
+    uptime.renner.uno/status-page-section: services
+spec:
+  type: group
+  displayName: Home Assistant
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: home-dns
+  namespace: home-assistant
+spec:
+  type: dns
+  displayName: Home Assistant DNS
+  parentRef:
+    name: home
+  interval: 60
+  retryInterval: 60
+  maxRetries: 1
+  dns:
+    # cluster services have no own record; they resolve through the *.renner.uno wildcard
+    hostname: home.renner.uno
+    resolveType: CNAME
+    resolveServer: "2606:4700:4700::1111,1.1.1.1"
+    conditions:
+      - operator: equals
+        value: proxy.renner.uno
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: home-http
+  namespace: home-assistant
+spec:
+  type: http
+  displayName: Home Assistant HTTP
+  parentRef:
+    name: home
+  interval: 60
+  retryInterval: 60
+  maxRetries: 1
+  timeout: 10
+  http:
+    # reachable: any answer from the backend below 5xx, redirects not followed
+    url: https://home.renner.uno/
+    acceptedStatusCodes: ["200-499"]
+    maxRedirects: 0
+    expiryNotification: true
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: home-api
+  namespace: home-assistant
+spec:
+  type: json-query
+  displayName: Home Assistant API
+  parentRef:
+    name: home
+  interval: 60
+  retryInterval: 60
+  maxRetries: 1
+  timeout: 10
+  http:
+    # unauthenticated login-provider list, served by the HA core backend
+    url: https://home.renner.uno/auth/providers
+    acceptedStatusCodes: ["200-299"]
+    expiryNotification: true
+  jsonQuery:
+    expression: "providers[type=\"homeassistant\"].name"
+    operator: "=="
+    expected: "Home Assistant Local"
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: home-web
+  namespace: home-assistant
+spec:
+  type: keyword
+  displayName: Home Assistant Web
+  parentRef:
+    name: home
+  interval: 60
+  retryInterval: 60
+  maxRetries: 1
+  timeout: 10
+  http:
+    url: https://home.renner.uno/
+    acceptedStatusCodes: ["200-299"]
+    expiryNotification: true
+  keyword:
+    keyword: "<title>Home Assistant</title>"

kubernetes/apps/home-assistant/kustomization.yaml

@@ -11,6 +11,7 @@ resources:
   - prometheus-token-externalsecret.yaml
   - config-sync-token-externalsecret.yaml
   - config-sync-gitea-externalsecret.yaml
+  - matrix-externalsecret.yaml
   - mosquitto-bootstrap.yaml
   # Former `health` probe credential. The broker no longer reads it (the
   # probes use the cert account mosquitto-probe, REN-953); removed with its
@@ -53,6 +54,7 @@ resources:
   - mqtt-account-controller.yaml
   # Also mounted by shelly-manager (../home-assistant-iot), which runs after this.
   - shelly-manager-auth-externalsecret.yaml
+  - kumamonitors.yaml
 configMapGenerator:
   # nginx config for the reverse-proxy sidecar. Hash suffix disabled so
   # the cm name stays stable; editing proxy.conf does not auto-roll the

kubernetes/apps/home-assistant/matrix-externalsecret.yaml

@@ -0,0 +1,19 @@
+# Password of @nabu:matrix.renner.uno (MAS account), rendered into
+# /config/secrets.yaml by the render-matrix-password init container.
+apiVersion: external-secrets.io/v1
+kind: ExternalSecret
+metadata:
+  name: ha-matrix
+  namespace: home-assistant
+spec:
+  refreshInterval: 1h
+  secretStoreRef:
+    kind: ClusterSecretStore
+    name: openbao
+  target:
+    name: ha-matrix
+  data:
+    - secretKey: nabu_password
+      remoteRef:
+        key: apps/home-assistant/matrix
+        property: nabu_password

kubernetes/apps/immich/kumamonitors.yaml

@@ -0,0 +1,76 @@
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: immich
+  namespace: immich
+  labels:
+    uptime.renner.uno/status-page-section: services
+spec:
+  type: group
+  displayName: Immich
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: immich-dns
+  namespace: immich
+spec:
+  type: dns
+  displayName: Immich DNS
+  parentRef:
+    name: immich
+  interval: 60
+  retryInterval: 60
+  maxRetries: 1
+  dns:
+    # cluster services have no own record; they resolve through the *.renner.uno wildcard
+    hostname: immich.renner.uno
+    resolveType: CNAME
+    resolveServer: "2606:4700:4700::1111,1.1.1.1"
+    conditions:
+      - operator: equals
+        value: proxy.renner.uno
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: immich-http
+  namespace: immich
+spec:
+  type: http
+  displayName: Immich HTTP
+  parentRef:
+    name: immich
+  interval: 60
+  retryInterval: 60
+  maxRetries: 1
+  timeout: 10
+  http:
+    # reachable: any answer from the backend below 5xx, redirects not followed
+    url: https://immich.renner.uno/
+    acceptedStatusCodes: ["200-499"]
+    maxRedirects: 0
+    expiryNotification: true
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: immich-api
+  namespace: immich
+spec:
+  type: json-query
+  displayName: Immich API
+  parentRef:
+    name: immich
+  interval: 60
+  retryInterval: 60
+  maxRetries: 1
+  timeout: 10
+  http:
+    url: https://immich.renner.uno/api/server/ping
+    acceptedStatusCodes: ["200-299"]
+    expiryNotification: true
+  jsonQuery:
+    expression: res
+    operator: "=="
+    expected: "pong"

kubernetes/apps/immich/kustomization.yaml

@@ -14,3 +14,4 @@ resources:
   - scheduled-backup.yaml
   - hetzner-creds-externalsecret.yaml
   - pvcs.yaml
+  - kumamonitors.yaml

kubernetes/apps/immich/machine-learning.yaml

@@ -32,7 +32,7 @@ spec:
           type: RuntimeDefault
       containers:
         - name: immich-machine-learning
-          image: ghcr.io/immich-app/immich-machine-learning:v3.3.3 # {"$imagepolicy": "flux-system:immich-machine-learning"}
+          image: ghcr.io/immich-app/immich-machine-learning:v3.3.4 # {"$imagepolicy": "flux-system:immich-machine-learning"}
           ports:
             - name: http
               containerPort: 3003

kubernetes/apps/immich/server.yaml

@@ -87,7 +87,7 @@ spec:
               mountPath: /ca
       containers:
         - name: immich-server
-          image: ghcr.io/immich-app/immich-server:v3.3.3 # {"$imagepolicy": "flux-system:immich-server"}
+          image: ghcr.io/immich-app/immich-server:v3.3.4 # {"$imagepolicy": "flux-system:immich-server"}
           ports:
             - name: http
               containerPort: 3001

kubernetes/apps/kuma-sync/deployment.yaml

@@ -30,7 +30,7 @@ spec:
           type: RuntimeDefault
       containers:
         - name: controller
-          image: gitea.renner.uno/gitea_admin/kuma-sync:2026-10-19-0646 # {"$imagepolicy": "flux-system:kuma-sync"}
+          image: gitea.renner.uno/gitea_admin/kuma-sync:2026-10-20-0933 # {"$imagepolicy": "flux-system:kuma-sync"}
           env:
             - name: KUMA_URL
               value: https://kuma.renner.uno

kubernetes/apps/kuma-sync/kustomization.yaml

@@ -1,8 +1,7 @@
 apiVersion: kustomize.config.k8s.io/v1beta1
 kind: Kustomization
 resources:
-  - crd-kumamonitors.yaml
   - externalsecret.yaml
   - rbac.yaml
   - deployment.yaml
-  - monitors
+  - statuspage-renner.yaml

kubernetes/apps/kuma-sync/monitors/audiobooks.yaml

@@ -1,53 +0,0 @@
-apiVersion: uptime.renner.uno/v1alpha1
-kind: KumaMonitor
-metadata:
-  name: audiobooks
-  namespace: kuma-sync
-spec:
-  type: group
-  displayName: Audiobooks
----
-apiVersion: uptime.renner.uno/v1alpha1
-kind: KumaMonitor
-metadata:
-  name: audiobooks-health
-  namespace: kuma-sync
-spec:
-  type: keyword
-  displayName: Audiobookshelf Health
-  parentRef:
-    name: audiobooks
-  interval: 60
-  retryInterval: 60
-  maxRetries: 1
-  timeout: 10
-  http:
-    url: https://audiobooks.renner.uno/healthcheck
-    acceptedStatusCodes: ["200-299"]
-    expiryNotification: true
-  keyword:
-    keyword: OK
----
-apiVersion: uptime.renner.uno/v1alpha1
-kind: KumaMonitor
-metadata:
-  name: audiobooks-status
-  namespace: kuma-sync
-spec:
-  type: json-query
-  displayName: Audiobookshelf Server
-  parentRef:
-    name: audiobooks
-  interval: 60
-  retryInterval: 60
-  maxRetries: 1
-  timeout: 10
-  http:
-    # initialized-server flag from the unauthenticated status endpoint
-    url: https://audiobooks.renner.uno/status
-    acceptedStatusCodes: ["200-299"]
-    expiryNotification: true
-  jsonQuery:
-    expression: isInit
-    operator: ==
-    expected: "true"

kubernetes/apps/kuma-sync/monitors/auth.yaml

@@ -1,48 +0,0 @@
-apiVersion: uptime.renner.uno/v1alpha1
-kind: KumaMonitor
-metadata:
-  name: auth
-  namespace: kuma-sync
-spec:
-  type: group
-  displayName: Authentik
----
-apiVersion: uptime.renner.uno/v1alpha1
-kind: KumaMonitor
-metadata:
-  name: auth-live
-  namespace: kuma-sync
-spec:
-  type: http
-  displayName: Authentik Live
-  parentRef:
-    name: auth
-  interval: 60
-  retryInterval: 60
-  maxRetries: 1
-  timeout: 10
-  http:
-    # ungated health endpoint, empty body
-    url: https://auth.renner.uno/-/health/live/
-    acceptedStatusCodes: ["200-299"]
-    expiryNotification: true
----
-apiVersion: uptime.renner.uno/v1alpha1
-kind: KumaMonitor
-metadata:
-  name: auth-ready
-  namespace: kuma-sync
-spec:
-  type: http
-  displayName: Authentik Ready
-  parentRef:
-    name: auth
-  interval: 60
-  retryInterval: 60
-  maxRetries: 1
-  timeout: 10
-  http:
-    # ungated readiness endpoint (database and cache), empty body
-    url: https://auth.renner.uno/-/health/ready/
-    acceptedStatusCodes: ["200-299"]
-    expiryNotification: true

kubernetes/apps/kuma-sync/monitors/docs.yaml

@@ -1,30 +0,0 @@
-apiVersion: uptime.renner.uno/v1alpha1
-kind: KumaMonitor
-metadata:
-  name: docs
-  namespace: kuma-sync
-spec:
-  type: group
-  displayName: Documents
----
-apiVersion: uptime.renner.uno/v1alpha1
-kind: KumaMonitor
-metadata:
-  name: docs-gate
-  namespace: kuma-sync
-spec:
-  type: keyword
-  displayName: Documents Login
-  parentRef:
-    name: docs
-  interval: 60
-  retryInterval: 60
-  maxRetries: 1
-  timeout: 20
-  http:
-    # Paperless is fully behind the Authentik gate; asserts the login page the redirect chain ends on
-    url: https://docs.renner.uno/
-    acceptedStatusCodes: ["200-299"]
-    expiryNotification: true
-  keyword:
-    keyword: <title>authentik</title>

kubernetes/apps/kuma-sync/monitors/home.yaml

@@ -1,53 +0,0 @@
-apiVersion: uptime.renner.uno/v1alpha1
-kind: KumaMonitor
-metadata:
-  name: home
-  namespace: kuma-sync
-spec:
-  type: group
-  displayName: Home Assistant
----
-apiVersion: uptime.renner.uno/v1alpha1
-kind: KumaMonitor
-metadata:
-  name: home-api
-  namespace: kuma-sync
-spec:
-  type: json-query
-  displayName: Home Assistant API
-  parentRef:
-    name: home
-  interval: 60
-  retryInterval: 60
-  maxRetries: 1
-  timeout: 10
-  http:
-    # unauthenticated login-provider list, served by the HA core backend
-    url: https://home.renner.uno/auth/providers
-    acceptedStatusCodes: ["200-299"]
-    expiryNotification: true
-  jsonQuery:
-    expression: providers[type="homeassistant"].name
-    operator: ==
-    expected: Home Assistant Local
----
-apiVersion: uptime.renner.uno/v1alpha1
-kind: KumaMonitor
-metadata:
-  name: home-web
-  namespace: kuma-sync
-spec:
-  type: keyword
-  displayName: Home Assistant Web
-  parentRef:
-    name: home
-  interval: 60
-  retryInterval: 60
-  maxRetries: 1
-  timeout: 10
-  http:
-    url: https://home.renner.uno/
-    acceptedStatusCodes: ["200-299"]
-    expiryNotification: true
-  keyword:
-    keyword: <title>Home Assistant</title>

kubernetes/apps/kuma-sync/monitors/immich.yaml

@@ -1,31 +0,0 @@
-apiVersion: uptime.renner.uno/v1alpha1
-kind: KumaMonitor
-metadata:
-  name: immich
-  namespace: kuma-sync
-spec:
-  type: group
-  displayName: Immich
----
-apiVersion: uptime.renner.uno/v1alpha1
-kind: KumaMonitor
-metadata:
-  name: immich-api
-  namespace: kuma-sync
-spec:
-  type: json-query
-  displayName: Immich API
-  parentRef:
-    name: immich
-  interval: 60
-  retryInterval: 60
-  maxRetries: 1
-  timeout: 10
-  http:
-    url: https://immich.renner.uno/api/server/ping
-    acceptedStatusCodes: ["200-299"]
-    expiryNotification: true
-  jsonQuery:
-    expression: res
-    operator: ==
-    expected: pong

kubernetes/apps/kuma-sync/monitors/kustomization.yaml

@@ -1,10 +0,0 @@
-apiVersion: kustomize.config.k8s.io/v1beta1
-kind: Kustomization
-resources:
-  - renner-uno.yaml
-  - home.yaml
-  - immich.yaml
-  - auth.yaml
-  - docs.yaml
-  - audiobooks.yaml
-  - third-party.yaml

kubernetes/apps/kuma-sync/monitors/renner-uno.yaml

@@ -1,51 +0,0 @@
-apiVersion: uptime.renner.uno/v1alpha1
-kind: KumaMonitor
-metadata:
-  name: renner-uno
-  namespace: kuma-sync
-spec:
-  type: group
-  displayName: Renner.uno Website
----
-apiVersion: uptime.renner.uno/v1alpha1
-kind: KumaMonitor
-metadata:
-  name: renner-uno-www
-  namespace: kuma-sync
-spec:
-  type: keyword
-  displayName: www.renner.uno
-  parentRef:
-    name: renner-uno
-  interval: 60
-  retryInterval: 60
-  maxRetries: 1
-  timeout: 10
-  http:
-    url: https://www.renner.uno/
-    acceptedStatusCodes: ["200-299"]
-    expiryNotification: true
-  keyword:
-    keyword: Familie Renner
----
-apiVersion: uptime.renner.uno/v1alpha1
-kind: KumaMonitor
-metadata:
-  name: renner-uno-apex
-  namespace: kuma-sync
-spec:
-  type: keyword
-  displayName: renner.uno
-  parentRef:
-    name: renner-uno
-  interval: 60
-  retryInterval: 60
-  maxRetries: 1
-  timeout: 10
-  http:
-    # 301 to www, followed
-    url: https://renner.uno/
-    acceptedStatusCodes: ["200-299"]
-    expiryNotification: true
-  keyword:
-    keyword: Familie Renner

kubernetes/apps/kuma-sync/monitors/third-party.yaml

@@ -1,87 +0,0 @@
-apiVersion: uptime.renner.uno/v1alpha1
-kind: KumaMonitor
-metadata:
-  name: third-party
-  namespace: kuma-sync
-spec:
-  type: group
-  displayName: Third-party
----
-apiVersion: uptime.renner.uno/v1alpha1
-kind: KumaMonitor
-metadata:
-  name: mcb-portal
-  namespace: kuma-sync
-spec:
-  type: http
-  displayName: MCB Portal
-  parentRef:
-    name: third-party
-  interval: 60
-  retryInterval: 60
-  maxRetries: 1
-  timeout: 15
-  http:
-    # root 302s to / to set a session cookie; Kuma keeps no cookies, so do not follow
-    url: https://portal.multi-circuit-boards.eu/
-    acceptedStatusCodes: ["200-299", "302"]
-    maxRedirects: 0
-    expiryNotification: true
----
-apiVersion: uptime.renner.uno/v1alpha1
-kind: KumaMonitor
-metadata:
-  name: mcb-tech
-  namespace: kuma-sync
-spec:
-  type: http
-  displayName: MCB Technician Portal
-  parentRef:
-    name: third-party
-  interval: 60
-  retryInterval: 60
-  maxRetries: 1
-  timeout: 15
-  http:
-    url: https://tech.multi-circuit-boards.eu/
-    acceptedStatusCodes: ["200-299"]
-    expiryNotification: true
----
-apiVersion: uptime.renner.uno/v1alpha1
-kind: KumaMonitor
-metadata:
-  name: mcb-www
-  namespace: kuma-sync
-spec:
-  type: http
-  displayName: MCB Website
-  parentRef:
-    name: third-party
-  interval: 60
-  retryInterval: 60
-  maxRetries: 1
-  timeout: 15
-  http:
-    # 301 to /index.html, followed
-    url: https://www.multi-circuit-boards.eu/
-    acceptedStatusCodes: ["200-299"]
-    expiryNotification: true
----
-apiVersion: uptime.renner.uno/v1alpha1
-kind: KumaMonitor
-metadata:
-  name: turm1388
-  namespace: kuma-sync
-spec:
-  type: http
-  displayName: Wohnen im Turm
-  parentRef:
-    name: third-party
-  interval: 60
-  retryInterval: 60
-  maxRetries: 1
-  timeout: 15
-  http:
-    url: https://turm1388.de/
-    acceptedStatusCodes: ["200-299"]
-    expiryNotification: true

kubernetes/apps/kuma-sync/rbac.yaml

@@ -7,20 +7,20 @@ metadata:
   labels:
     app.kubernetes.io/name: kuma-sync
 ---
-# Cluster-wide: KumaMonitor objects live in every app namespace.
+# Cluster-wide: KumaMonitor and KumaStatusPage objects live in any namespace.
 apiVersion: rbac.authorization.k8s.io/v1
 kind: ClusterRole
 metadata:
   name: kuma-sync
 rules:
   - apiGroups: ["uptime.renner.uno"]
-    resources: ["kumamonitors"]
+    resources: ["kumamonitors", "kumastatuspages"]
     verbs: ["get", "list", "watch", "update", "patch"]
   - apiGroups: ["uptime.renner.uno"]
-    resources: ["kumamonitors/status"]
+    resources: ["kumamonitors/status", "kumastatuspages/status"]
     verbs: ["get", "update", "patch"]
   - apiGroups: ["uptime.renner.uno"]
-    resources: ["kumamonitors/finalizers"]
+    resources: ["kumamonitors/finalizers", "kumastatuspages/finalizers"]
     verbs: ["update"]
   - apiGroups: [""]
     resources: ["events"]

kubernetes/apps/kuma-sync/statuspage-renner.yaml

@@ -0,0 +1,24 @@
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaStatusPage
+metadata:
+  name: renner
+  namespace: kuma-sync
+spec:
+  slug: renner
+  title: Renner
+  domainNames:
+    - uptime.renner.uno
+  theme: auto
+  showPoweredBy: true
+  showTags: false
+  showCertificateExpiry: false
+  sections:
+    - name: Services
+      selector:
+        matchLabels:
+          uptime.renner.uno/status-page-section: services
+    - name: Third-party
+      selector:
+        matchLabels:
+          uptime.renner.uno/status-page-section: third-party

kubernetes/apps/llama-server/kumamonitors.yaml

@@ -0,0 +1,75 @@
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: llm
+  namespace: ai
+  labels:
+    uptime.renner.uno/status-page-section: services
+spec:
+  type: group
+  displayName: LLM
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: llm-dns
+  namespace: ai
+spec:
+  type: dns
+  displayName: LLM DNS
+  parentRef:
+    name: llm
+  interval: 60
+  retryInterval: 60
+  maxRetries: 1
+  dns:
+    # cluster services have no own record; they resolve through the *.renner.uno wildcard
+    hostname: llm.renner.uno
+    resolveType: CNAME
+    resolveServer: "2606:4700:4700::1111,1.1.1.1"
+    conditions:
+      - operator: equals
+        value: proxy.renner.uno
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: llm-http
+  namespace: ai
+spec:
+  type: http
+  displayName: LLM HTTP
+  parentRef:
+    name: llm
+  interval: 60
+  retryInterval: 60
+  maxRetries: 1
+  timeout: 10
+  http:
+    # reachable: any answer from the backend below 5xx, redirects not followed
+    url: https://llm.renner.uno/
+    acceptedStatusCodes: ["200-499"]
+    maxRedirects: 0
+    expiryNotification: true
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: llm-gate
+  namespace: ai
+spec:
+  type: keyword
+  displayName: LLM Login
+  parentRef:
+    name: llm
+  interval: 60
+  retryInterval: 60
+  maxRetries: 1
+  timeout: 20
+  http:
+    # fully behind the Authentik gate; asserts the login page the redirect chain ends on
+    url: https://llm.renner.uno/
+    acceptedStatusCodes: ["200-299"]
+    expiryNotification: true
+  keyword:
+    keyword: "<title>authentik</title>"

kubernetes/apps/llama-server/kustomization.yaml

@@ -7,3 +7,4 @@ resources:
   - ingress.yaml
   - wiki-embed.yaml
   - wiki-embed-ingress.yaml
+  - kumamonitors.yaml

kubernetes/apps/matrix/ingress.yaml

@@ -100,6 +100,21 @@ spec:
                 name: synapse
                 port:
                   number: 8008
+          # lk-jwt-service resolves the server via this file and verifies OpenID tokens at the path below.
+          - path: /.well-known/matrix/server
+            pathType: Exact
+            backend:
+              service:
+                name: synapse
+                port:
+                  number: 8008
+          - path: /_matrix/federation/v1/openid/userinfo
+            pathType: Exact
+            backend:
+              service:
+                name: synapse
+                port:
+                  number: 8008
 ---
 apiVersion: networking.k8s.io/v1
 kind: Ingress

kubernetes/apps/matrix/kumamonitors.yaml

@@ -0,0 +1,363 @@
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: matrix
+  namespace: matrix
+  labels:
+    uptime.renner.uno/status-page-section: services
+spec:
+  type: group
+  displayName: Matrix
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: matrix-dns
+  namespace: matrix
+spec:
+  type: dns
+  displayName: Synapse DNS
+  parentRef:
+    name: matrix
+  interval: 60
+  retryInterval: 60
+  maxRetries: 1
+  dns:
+    # cluster services have no own record; they resolve through the *.renner.uno wildcard
+    hostname: matrix.renner.uno
+    resolveType: CNAME
+    resolveServer: "2606:4700:4700::1111,1.1.1.1"
+    conditions:
+      - operator: equals
+        value: proxy.renner.uno
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: matrix-http
+  namespace: matrix
+spec:
+  type: http
+  displayName: Synapse HTTP
+  parentRef:
+    name: matrix
+  interval: 60
+  retryInterval: 60
+  maxRetries: 1
+  timeout: 10
+  http:
+    # reachable: any answer from the backend below 5xx, redirects not followed
+    url: https://matrix.renner.uno/_matrix/client/versions
+    acceptedStatusCodes: ["200-499"]
+    maxRedirects: 0
+    expiryNotification: true
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: matrix-versions
+  namespace: matrix
+spec:
+  type: json-query
+  displayName: Synapse Client API
+  parentRef:
+    name: matrix
+  interval: 60
+  retryInterval: 60
+  maxRetries: 1
+  timeout: 10
+  http:
+    url: https://matrix.renner.uno/_matrix/client/versions
+    acceptedStatusCodes: ["200-299"]
+    expiryNotification: true
+  jsonQuery:
+    expression: $count(versions)
+    operator: ">"
+    expected: "0"
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: matrix-well-known
+  namespace: matrix
+spec:
+  type: json-query
+  displayName: Matrix Client Discovery
+  parentRef:
+    name: matrix
+  interval: 60
+  retryInterval: 60
+  maxRetries: 1
+  timeout: 10
+  http:
+    url: https://matrix.renner.uno/.well-known/matrix/client
+    acceptedStatusCodes: ["200-299"]
+    expiryNotification: true
+  jsonQuery:
+    expression: "`m.homeserver`.base_url"
+    operator: "=="
+    expected: "https://matrix.renner.uno/"
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: matrix-login
+  namespace: matrix
+spec:
+  type: json-query
+  displayName: Matrix Login (MAS)
+  parentRef:
+    name: matrix
+  interval: 60
+  retryInterval: 60
+  maxRetries: 1
+  timeout: 10
+  http:
+    # login path routed to MAS; asserts SSO is offered
+    url: https://matrix.renner.uno/_matrix/client/v3/login
+    acceptedStatusCodes: ["200-299"]
+    expiryNotification: true
+  jsonQuery:
+    expression: "\"m.login.sso\" in flows.type"
+    operator: "=="
+    expected: "true"
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: mas-dns
+  namespace: matrix
+spec:
+  type: dns
+  displayName: MAS DNS
+  parentRef:
+    name: matrix
+  interval: 60
+  retryInterval: 60
+  maxRetries: 1
+  dns:
+    # cluster services have no own record; they resolve through the *.renner.uno wildcard
+    hostname: account.matrix.renner.uno
+    resolveType: CNAME
+    resolveServer: "2606:4700:4700::1111,1.1.1.1"
+    conditions:
+      - operator: equals
+        value: proxy.renner.uno
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: mas-http
+  namespace: matrix
+spec:
+  type: http
+  displayName: MAS HTTP
+  parentRef:
+    name: matrix
+  interval: 60
+  retryInterval: 60
+  maxRetries: 1
+  timeout: 10
+  http:
+    # reachable: any answer from the backend below 5xx, redirects not followed
+    url: https://account.matrix.renner.uno/
+    acceptedStatusCodes: ["200-499"]
+    maxRedirects: 0
+    expiryNotification: true
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: mas-discovery
+  namespace: matrix
+spec:
+  type: json-query
+  displayName: MAS OIDC Discovery
+  parentRef:
+    name: matrix
+  interval: 60
+  retryInterval: 60
+  maxRetries: 1
+  timeout: 10
+  http:
+    url: https://account.matrix.renner.uno/.well-known/openid-configuration
+    acceptedStatusCodes: ["200-299"]
+    expiryNotification: true
+  jsonQuery:
+    expression: issuer
+    operator: "=="
+    expected: "https://account.matrix.renner.uno/"
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: element-dns
+  namespace: matrix
+spec:
+  type: dns
+  displayName: Element DNS
+  parentRef:
+    name: matrix
+  interval: 60
+  retryInterval: 60
+  maxRetries: 1
+  dns:
+    # cluster services have no own record; they resolve through the *.renner.uno wildcard
+    hostname: element.renner.uno
+    resolveType: CNAME
+    resolveServer: "2606:4700:4700::1111,1.1.1.1"
+    conditions:
+      - operator: equals
+        value: proxy.renner.uno
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: element-http
+  namespace: matrix
+spec:
+  type: http
+  displayName: Element HTTP
+  parentRef:
+    name: matrix
+  interval: 60
+  retryInterval: 60
+  maxRetries: 1
+  timeout: 10
+  http:
+    # reachable: any answer from the backend below 5xx, redirects not followed
+    url: https://element.renner.uno/
+    acceptedStatusCodes: ["200-499"]
+    maxRedirects: 0
+    expiryNotification: true
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: element-web
+  namespace: matrix
+spec:
+  type: keyword
+  displayName: Element Web
+  parentRef:
+    name: matrix
+  interval: 60
+  retryInterval: 60
+  maxRetries: 1
+  timeout: 10
+  http:
+    url: https://element.renner.uno/
+    acceptedStatusCodes: ["200-299"]
+    expiryNotification: true
+  keyword:
+    keyword: "<title>Element</title>"
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: element-config
+  namespace: matrix
+spec:
+  type: json-query
+  displayName: Element Config
+  parentRef:
+    name: matrix
+  interval: 60
+  retryInterval: 60
+  maxRetries: 1
+  timeout: 10
+  http:
+    url: https://element.renner.uno/config.json
+    acceptedStatusCodes: ["200-299"]
+    expiryNotification: true
+  jsonQuery:
+    expression: "default_server_config.`m.homeserver`.base_url"
+    operator: "=="
+    expected: "https://matrix.renner.uno"
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: rtc-dns
+  namespace: matrix
+spec:
+  type: dns
+  displayName: MatrixRTC DNS
+  parentRef:
+    name: matrix
+  interval: 60
+  retryInterval: 60
+  maxRetries: 1
+  dns:
+    # cluster services have no own record; they resolve through the *.renner.uno wildcard
+    hostname: rtc.matrix.renner.uno
+    resolveType: CNAME
+    resolveServer: "2606:4700:4700::1111,1.1.1.1"
+    conditions:
+      - operator: equals
+        value: proxy.renner.uno
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: rtc-sfu
+  namespace: matrix
+spec:
+  type: keyword
+  displayName: LiveKit SFU
+  parentRef:
+    name: matrix
+  interval: 60
+  retryInterval: 60
+  maxRetries: 1
+  timeout: 10
+  http:
+    # LiveKit's health answer on its signalling port
+    url: https://rtc.matrix.renner.uno/
+    acceptedStatusCodes: ["200-299"]
+    expiryNotification: true
+  keyword:
+    keyword: "OK"
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: rtc-jwt
+  namespace: matrix
+spec:
+  type: http
+  displayName: MatrixRTC Authorization Service
+  parentRef:
+    name: matrix
+  interval: 60
+  retryInterval: 60
+  maxRetries: 1
+  timeout: 10
+  http:
+    # reachable: any answer from the backend below 5xx (an unauthenticated GET is rejected with 4xx)
+    url: https://rtc.matrix.renner.uno/livekit/jwt/sfu/get
+    acceptedStatusCodes: ["200-499"]
+    maxRedirects: 0
+    expiryNotification: true
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: turn-dns
+  namespace: matrix
+spec:
+  type: dns
+  displayName: TURN DNS
+  parentRef:
+    name: matrix
+  interval: 60
+  retryInterval: 60
+  maxRetries: 1
+  dns:
+    # cluster services have no own record; they resolve through the *.renner.uno wildcard
+    hostname: turn.matrix.renner.uno
+    resolveType: CNAME
+    resolveServer: "2606:4700:4700::1111,1.1.1.1"
+    conditions:
+      - operator: equals
+        value: proxy.renner.uno

kubernetes/apps/matrix/kustomization.yaml

@@ -5,9 +5,11 @@ resources:
   - synapse.yaml
   - mas.yaml
   - element.yaml
+  - rtc.yaml
   - ingress.yaml
   # mx-pg CNPG Postgres + offsite Barman backup. The media store and signing
   # key are on synapse-data, backed up by Velero (matrix-daily).
   - cluster.yaml
   - scheduled-backup.yaml
   - hetzner-creds-externalsecret.yaml
+  - kumamonitors.yaml

kubernetes/apps/matrix/rtc.yaml

@@ -0,0 +1,415 @@
+# MatrixRTC backend for Element Call: LiveKit SFU + lk-jwt-service.
+# Generated once in-cluster; Synapse, LiveKit and lk-jwt-service read the same Secret.
+apiVersion: generators.external-secrets.io/v1alpha1
+kind: Password
+metadata:
+  name: matrix-rtc
+  namespace: matrix
+spec:
+  length: 64
+  digits: 16
+  symbols: 0
+  allowRepeat: true
+  noUpper: false
+  secretKeys:
+    - livekit_secret
+    - as_token
+    - hs_token
+---
+apiVersion: external-secrets.io/v1
+kind: ExternalSecret
+metadata:
+  name: matrix-rtc
+  namespace: matrix
+spec:
+  refreshPolicy: CreatedOnce
+  target:
+    name: matrix-rtc
+    template:
+      engineVersion: v2
+      data:
+        livekit_secret: "{{ .livekit_secret }}"
+        # LIVEKIT_KEYS format "<key>: <secret>"; the key name is the fixed id matrix-rtc.
+        livekit_keys: "matrix-rtc: {{ .livekit_secret }}"
+        # Appservice registration: membership look-ups and the /rtc/livekit proxy only, no event traffic.
+        registration.yaml: |
+          id: lk-jwt-service
+          url: null
+          as_token: "{{ .as_token }}"
+          hs_token: "{{ .hs_token }}"
+          sender_localpart: _lk_jwt_service
+          rate_limited: false
+          namespaces:
+            users:
+              - exclusive: false
+                regex: ".*"
+            aliases: []
+            rooms: []
+          io.element.msc4502.scopes: ["urn:matrix:client:io.element.msc4502:rooms:is_joined"]
+          io.element.msc4512.proxy_prefix: "rtc/livekit"
+          io.element.msc4512.proxy_url: "http://lk-jwt-service:8080"
+  dataFrom:
+    - sourceRef:
+        generatorRef:
+          apiVersion: generators.external-secrets.io/v1alpha1
+          kind: Password
+          name: matrix-rtc
+---
+apiVersion: v1
+kind: ConfigMap
+metadata:
+  name: livekit-config
+  namespace: matrix
+data:
+  livekit.yaml: |
+    port: 7880
+    rtc:
+      # Host candidates are the pod IPs (dual-stack, BGP-routed to the LAN).
+      use_external_ip: false
+      tcp_port: 7881
+      udp_port: 7882
+    turn:
+      # TURN/TLS on turn.matrix.renner.uno:443; Traefik terminates TLS (IngressRouteTCP livekit-turn).
+      enabled: true
+      domain: turn.matrix.renner.uno
+      tls_port: 443
+      external_tls: true
+      # The relay targets the SFU's own pod IP; LiveKit limits embedded-TURN relays to its own media ports.
+      allow_restricted_peer_cidrs:
+        - 10.0.0.0/8
+        - fc00::/7
+    room:
+      # lk-jwt-service creates rooms for matrix.renner.uno users only.
+      auto_create: false
+    webhook:
+      api_key: matrix-rtc
+      urls:
+        - http://lk-jwt-service:8080/sfu_webhook
+    logging:
+      level: info
+---
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: livekit
+  namespace: matrix
+  annotations:
+    configmap.reloader.stakater.com/reload: livekit-config
+    secret.reloader.stakater.com/reload: matrix-rtc
+  labels:
+    app.kubernetes.io/name: livekit
+    app.kubernetes.io/part-of: matrix
+spec:
+  replicas: 1
+  # One SFU: two pods would split a call's participants.
+  strategy:
+    type: Recreate
+  selector:
+    matchLabels:
+      app.kubernetes.io/name: livekit
+  template:
+    metadata:
+      labels:
+        app.kubernetes.io/name: livekit
+        app.kubernetes.io/part-of: matrix
+    spec:
+      automountServiceAccountToken: false
+      # Service links would inject LIVEKIT_PORT=tcp://... (Service livekit), which LiveKit and lk-jwt-service read as config.
+      enableServiceLinks: false
+      securityContext:
+        runAsNonRoot: true
+        runAsUser: 65534
+        runAsGroup: 65534
+        seccompProfile:
+          type: RuntimeDefault
+      containers:
+        - name: livekit
+          image: livekit/livekit-server:v1.13.10@sha256:89ca9ce0791e18d6e03bf6e2c49ceb27e1c754eae8bd50c989386c1a5963791a
+          args:
+            - --config
+            - /config/livekit.yaml
+          securityContext:
+            allowPrivilegeEscalation: false
+            readOnlyRootFilesystem: true
+            capabilities:
+              drop: ["ALL"]
+          env:
+            - name: LIVEKIT_KEYS
+              valueFrom:
+                secretKeyRef:
+                  name: matrix-rtc
+                  key: livekit_keys
+          ports:
+            - name: http
+              containerPort: 7880
+            - name: ice-tcp
+              containerPort: 7881
+            - name: ice-udp
+              containerPort: 7882
+              protocol: UDP
+            - name: turn
+              containerPort: 443
+          resources:
+            requests:
+              cpu: 100m
+              memory: 128Mi
+            limits:
+              memory: 1Gi
+          readinessProbe:
+            httpGet:
+              path: /
+              port: http
+            periodSeconds: 10
+          livenessProbe:
+            httpGet:
+              path: /
+              port: http
+            periodSeconds: 30
+            timeoutSeconds: 5
+            failureThreshold: 4
+          volumeMounts:
+            - name: config
+              mountPath: /config
+              readOnly: true
+      volumes:
+        - name: config
+          configMap:
+            name: livekit-config
+---
+apiVersion: v1
+kind: Service
+metadata:
+  name: livekit
+  namespace: matrix
+spec:
+  selector:
+    app.kubernetes.io/name: livekit
+  ports:
+    - name: http
+      port: 7880
+      targetPort: http
+    - name: turn
+      port: 443
+      targetPort: turn
+---
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: lk-jwt-service
+  namespace: matrix
+  annotations:
+    secret.reloader.stakater.com/reload: matrix-rtc
+  labels:
+    app.kubernetes.io/name: lk-jwt-service
+    app.kubernetes.io/part-of: matrix
+spec:
+  replicas: 1
+  selector:
+    matchLabels:
+      app.kubernetes.io/name: lk-jwt-service
+  template:
+    metadata:
+      labels:
+        app.kubernetes.io/name: lk-jwt-service
+        app.kubernetes.io/part-of: matrix
+    spec:
+      automountServiceAccountToken: false
+      # Service links would inject LIVEKIT_PORT=tcp://... (Service livekit), which LiveKit and lk-jwt-service read as config.
+      enableServiceLinks: false
+      securityContext:
+        runAsNonRoot: true
+        runAsUser: 65534
+        runAsGroup: 65534
+        seccompProfile:
+          type: RuntimeDefault
+      containers:
+        - name: lk-jwt-service
+          image: ghcr.io/element-hq/lk-jwt-service:0.9.0@sha256:d210fd778ba38b7e42e6fc64e8a24a7d66ccc3b938fb20d73bd713224af2dfea
+          securityContext:
+            allowPrivilegeEscalation: false
+            readOnlyRootFilesystem: true
+            capabilities:
+              drop: ["ALL"]
+          env:
+            # Must equal matrix_rtc.transports[].url in synapse.yaml.
+            - name: LIVEKIT_URL
+              value: wss://rtc.matrix.renner.uno
+            - name: LIVEKIT_KEY
+              value: matrix-rtc
+            - name: LIVEKIT_SECRET
+              valueFrom:
+                secretKeyRef:
+                  name: matrix-rtc
+                  key: livekit_secret
+            - name: LIVEKIT_FULL_ACCESS_HOMESERVERS
+              value: matrix.renner.uno
+            # Federation is off: no remote homeserver publishes on this SFU.
+            - name: LIVEKIT_REMOTE_CAN_PUBLISH_HOMESERVERS
+              value: ""
+            - name: LIVEKIT_AS_REGISTRATION_FILE
+              value: /registration/registration.yaml
+            - name: LIVEKIT_HS_SERVER_NAME
+              value: matrix.renner.uno
+            - name: LIVEKIT_CS_API_URL_OVERRIDES
+              value: matrix.renner.uno=http://synapse:8008
+            - name: LIVEKIT_SANITY_CHECK_INTERVAL_SECONDS
+              value: "60"
+          ports:
+            - name: http
+              containerPort: 8080
+          resources:
+            requests:
+              cpu: 10m
+              memory: 32Mi
+            limits:
+              memory: 256Mi
+          readinessProbe:
+            httpGet:
+              path: /healthz
+              port: http
+            periodSeconds: 10
+          livenessProbe:
+            httpGet:
+              path: /healthz
+              port: http
+            periodSeconds: 30
+            timeoutSeconds: 5
+            failureThreshold: 4
+          volumeMounts:
+            - name: registration
+              mountPath: /registration
+              readOnly: true
+      volumes:
+        - name: registration
+          secret:
+            secretName: matrix-rtc
+            items:
+              - key: registration.yaml
+                path: registration.yaml
+---
+apiVersion: v1
+kind: Service
+metadata:
+  name: lk-jwt-service
+  namespace: matrix
+spec:
+  selector:
+    app.kubernetes.io/name: lk-jwt-service
+  ports:
+    - name: http
+      port: 8080
+      targetPort: http
+---
+apiVersion: traefik.io/v1alpha1
+kind: Middleware
+metadata:
+  name: lk-jwt-strip
+  namespace: matrix
+spec:
+  stripPrefix:
+    prefixes:
+      - /livekit/jwt
+---
+apiVersion: networking.k8s.io/v1
+kind: Ingress
+metadata:
+  name: matrix-rtc
+  namespace: matrix
+  labels:
+    dns.renner.uno/public: "true"
+  annotations:
+    cert-manager.io/cluster-issuer: letsencrypt-cluster
+    traefik.ingress.kubernetes.io/router.middlewares: matrix-lk-jwt-strip@kubernetescrd
+spec:
+  ingressClassName: traefik
+  tls:
+    - hosts:
+        - rtc.matrix.renner.uno
+      secretName: rtc-tls
+  rules:
+    - host: rtc.matrix.renner.uno
+      http:
+        paths:
+          # Client endpoints of lk-jwt-service (livekit_service_url); the rest of the service stays in-cluster.
+          - path: /livekit/jwt/sfu/get
+            pathType: Exact
+            backend:
+              service:
+                name: lk-jwt-service
+                port:
+                  number: 8080
+          - path: /livekit/jwt/get_token
+            pathType: Exact
+            backend:
+              service:
+                name: lk-jwt-service
+                port:
+                  number: 8080
+          - path: /livekit/jwt/delegate_delayed_leave
+            pathType: Exact
+            backend:
+              service:
+                name: lk-jwt-service
+                port:
+                  number: 8080
+          - path: /
+            pathType: Prefix
+            backend:
+              service:
+                name: livekit
+                port:
+                  number: 7880
+---
+# Publishes turn.matrix.renner.uno (netbird-service-sync reads Ingress hosts). Bound to `web` only:
+# an HTTPS router for the same SNI on websecure would take precedence over IngressRouteTCP livekit-turn.
+apiVersion: networking.k8s.io/v1
+kind: Ingress
+metadata:
+  name: livekit-turn
+  namespace: matrix
+  labels:
+    dns.renner.uno/public: "true"
+  annotations:
+    traefik.ingress.kubernetes.io/router.entrypoints: web
+spec:
+  ingressClassName: traefik
+  rules:
+    - host: turn.matrix.renner.uno
+      http:
+        paths:
+          - path: /
+            pathType: Prefix
+            backend:
+              service:
+                name: livekit
+                port:
+                  number: 7880
+---
+apiVersion: cert-manager.io/v1
+kind: Certificate
+metadata:
+  name: livekit-turn
+  namespace: matrix
+spec:
+  secretName: livekit-turn-tls
+  dnsNames:
+    - turn.matrix.renner.uno
+  issuerRef:
+    kind: ClusterIssuer
+    name: letsencrypt-cluster
+---
+apiVersion: traefik.io/v1alpha1
+kind: IngressRouteTCP
+metadata:
+  name: livekit-turn
+  namespace: matrix
+spec:
+  entryPoints:
+    - websecure
+  routes:
+    - match: HostSNI(`turn.matrix.renner.uno`)
+      services:
+        - name: livekit
+          port: 443
+  tls:
+    secretName: livekit-turn-tls

kubernetes/apps/matrix/synapse.yaml

@@ -19,8 +19,15 @@ data:
     server_name: matrix.renner.uno
     public_baseurl: https://matrix.renner.uno/
     # Lets Element X and other clients discover the homeserver from the
-    # server name. No server well-known: there is no federation to point at.
+    # server name.
     serve_client_wellknown: true
+    # Delegates to :443 so lk-jwt-service finds /_matrix/federation/v1/openid/userinfo (openid resource below).
+    serve_server_wellknown: true
+    # Element Call builds that still read the MatrixRTC transport from the well-known.
+    extra_well_known_client_content:
+      org.matrix.msc4143.rtc_foci:
+        - type: livekit
+          livekit_service_url: https://rtc.matrix.renner.uno/livekit/jwt
     pid_file: /tmp/homeserver.pid
     report_stats: false
 
@@ -34,7 +41,8 @@ data:
         bind_addresses: ["::"]
         x_forwarded: true
         resources:
-          - names: [client]
+          # openid: only the OpenID userinfo endpoint lk-jwt-service verifies call tokens with; no federation.
+          - names: [client, openid]
             compress: false
 
     # The password comes from PGPASSWORD (libpq reads it), so no credential
@@ -73,6 +81,30 @@ data:
     experimental_features:
       msc4108_enabled: true
       msc4388_mode: open
+      # MatrixRTC (Element Call): transports endpoint, sync state_after,
+      # appservice membership look-ups and the /rtc/livekit proxy to lk-jwt-service.
+      msc4143_enabled: true
+      msc4222_enabled: true
+      msc4502_enabled: true
+      msc4512_enabled: true
+
+    # MatrixRTC transport (rtc.yaml). url must equal LIVEKIT_URL of lk-jwt-service.
+    matrix_rtc:
+      transports:
+        - type: livekit
+          url: wss://rtc.matrix.renner.uno
+          livekit_service_url: https://rtc.matrix.renner.uno/livekit/jwt
+    app_service_config_files:
+      - /appservices/lk-jwt-service/registration.yaml
+    # Call membership leaves via delayed events (MSC4140).
+    max_event_delay_duration: 24h
+    # Element Call self-hosting guide values: E2EE key sharing bursts and 5 s membership heartbeats.
+    rc_message:
+      per_second: 0.5
+      burst_count: 30
+    rc_delayed_event_mgmt:
+      per_second: 1
+      burst_count: 20
 
     # Federation off.
     federation_domain_whitelist: []
@@ -115,7 +147,7 @@ metadata:
   namespace: matrix
   annotations:
     configmap.reloader.stakater.com/reload: synapse-config,mas-config
-    secret.reloader.stakater.com/reload: synapse-secrets
+    secret.reloader.stakater.com/reload: synapse-secrets,matrix-rtc
   labels:
     app.kubernetes.io/name: synapse
     app.kubernetes.io/part-of: matrix
@@ -263,6 +295,9 @@ spec:
               mountPath: /data
             - name: tmp
               mountPath: /tmp
+            - name: appservice-lk-jwt
+              mountPath: /appservices/lk-jwt-service
+              readOnly: true
       volumes:
         - name: config
           configMap:
@@ -295,6 +330,12 @@ spec:
             claimName: synapse-data
         - name: tmp
           emptyDir: {}
+        - name: appservice-lk-jwt
+          secret:
+            secretName: matrix-rtc
+            items:
+              - key: registration.yaml
+                path: registration.yaml
 ---
 apiVersion: v1
 kind: Service

kubernetes/apps/monitoring/kumamonitors.yaml

@@ -0,0 +1,448 @@
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: netbird-proxies
+  namespace: monitoring
+  labels:
+    uptime.renner.uno/status-page-section: services
+spec:
+  type: group
+  displayName: NetBird Proxies
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: netbird-proxies-dns
+  namespace: monitoring
+spec:
+  type: dns
+  displayName: proxy.renner.uno DNS
+  parentRef:
+    name: netbird-proxies
+  interval: 60
+  retryInterval: 60
+  maxRetries: 1
+  dns:
+    # target of the *.renner.uno wildcard
+    hostname: proxy.renner.uno
+    resolveType: AAAA
+    resolveServer: "2606:4700:4700::1111,1.1.1.1"
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: proxy-1
+  namespace: monitoring
+spec:
+  type: group
+  displayName: proxy-1.renner.uno
+  parentRef:
+    name: netbird-proxies
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: proxy-1-dns
+  namespace: monitoring
+spec:
+  type: dns
+  displayName: proxy-1.renner.uno DNS
+  parentRef:
+    name: proxy-1
+  interval: 60
+  retryInterval: 60
+  maxRetries: 1
+  dns:
+    hostname: proxy-1.renner.uno
+    resolveType: AAAA
+    resolveServer: "2606:4700:4700::1111,1.1.1.1"
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: proxy-1-http
+  namespace: monitoring
+spec:
+  type: http
+  displayName: proxy-1.renner.uno HTTP
+  parentRef:
+    name: proxy-1
+  interval: 60
+  retryInterval: 60
+  maxRetries: 1
+  timeout: 10
+  http:
+    # pinned to this proxy; the Host header sets SNI, so the proxy routes status.renner.uno
+    url: https://proxy-1.renner.uno/
+    acceptedStatusCodes: ["200-499"]
+    maxRedirects: 0
+    headers:
+      Host: status.renner.uno
+    expiryNotification: true
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: proxy-1-route
+  namespace: monitoring
+spec:
+  type: json-query
+  displayName: proxy-1.renner.uno Route
+  parentRef:
+    name: proxy-1
+  interval: 60
+  retryInterval: 60
+  maxRetries: 1
+  timeout: 10
+  http:
+    # end to end through this proxy, the mesh and Traefik to Gatus
+    url: https://proxy-1.renner.uno/health
+    acceptedStatusCodes: ["200-299"]
+    headers:
+      Host: status.renner.uno
+    expiryNotification: true
+  jsonQuery:
+    expression: status
+    operator: "=="
+    expected: "UP"
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: proxy-2
+  namespace: monitoring
+spec:
+  type: group
+  displayName: proxy-2.renner.uno
+  parentRef:
+    name: netbird-proxies
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: proxy-2-dns
+  namespace: monitoring
+spec:
+  type: dns
+  displayName: proxy-2.renner.uno DNS
+  parentRef:
+    name: proxy-2
+  interval: 60
+  retryInterval: 60
+  maxRetries: 1
+  dns:
+    hostname: proxy-2.renner.uno
+    resolveType: AAAA
+    resolveServer: "2606:4700:4700::1111,1.1.1.1"
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: proxy-2-dns-a
+  namespace: monitoring
+spec:
+  type: dns
+  displayName: proxy-2.renner.uno DNS (IPv4)
+  parentRef:
+    name: proxy-2
+  interval: 60
+  retryInterval: 60
+  maxRetries: 1
+  dns:
+    # the fleet's only IPv4 address
+    hostname: proxy-2.renner.uno
+    resolveType: A
+    resolveServer: "2606:4700:4700::1111,1.1.1.1"
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: proxy-2-http
+  namespace: monitoring
+spec:
+  type: http
+  displayName: proxy-2.renner.uno HTTP
+  parentRef:
+    name: proxy-2
+  interval: 60
+  retryInterval: 60
+  maxRetries: 1
+  timeout: 10
+  http:
+    # pinned to this proxy; the Host header sets SNI, so the proxy routes status.renner.uno
+    url: https://proxy-2.renner.uno/
+    acceptedStatusCodes: ["200-499"]
+    maxRedirects: 0
+    headers:
+      Host: status.renner.uno
+    expiryNotification: true
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: proxy-2-route
+  namespace: monitoring
+spec:
+  type: json-query
+  displayName: proxy-2.renner.uno Route
+  parentRef:
+    name: proxy-2
+  interval: 60
+  retryInterval: 60
+  maxRetries: 1
+  timeout: 10
+  http:
+    # end to end through this proxy, the mesh and Traefik to Gatus
+    url: https://proxy-2.renner.uno/health
+    acceptedStatusCodes: ["200-299"]
+    headers:
+      Host: status.renner.uno
+    expiryNotification: true
+  jsonQuery:
+    expression: status
+    operator: "=="
+    expected: "UP"
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: renner-uno-apex
+  namespace: monitoring
+  labels:
+    uptime.renner.uno/status-page-section: services
+spec:
+  type: group
+  displayName: renner.uno Apex
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: renner-uno-apex-dns
+  namespace: monitoring
+spec:
+  type: dns
+  displayName: renner.uno DNS
+  parentRef:
+    name: renner-uno-apex
+  interval: 60
+  retryInterval: 60
+  maxRetries: 1
+  dns:
+    # Cloudflare-proxied apex, not the wildcard
+    hostname: renner.uno
+    resolveType: AAAA
+    resolveServer: "2606:4700:4700::1111,1.1.1.1"
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: renner-uno-apex-http
+  namespace: monitoring
+spec:
+  type: http
+  displayName: renner.uno HTTP
+  parentRef:
+    name: renner-uno-apex
+  interval: 60
+  retryInterval: 60
+  maxRetries: 1
+  timeout: 10
+  http:
+    # reachable: any answer from the backend below 5xx, redirects not followed
+    url: https://renner.uno/
+    acceptedStatusCodes: ["200-499"]
+    maxRedirects: 0
+    expiryNotification: true
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: renner-uno-apex-redirect
+  namespace: monitoring
+spec:
+  type: keyword
+  displayName: renner.uno
+  parentRef:
+    name: renner-uno-apex
+  interval: 60
+  retryInterval: 60
+  maxRetries: 1
+  timeout: 10
+  http:
+    # 301 to www, followed
+    url: https://renner.uno/
+    acceptedStatusCodes: ["200-299"]
+    expiryNotification: true
+  keyword:
+    keyword: Familie Renner
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: third-party
+  namespace: monitoring
+spec:
+  type: group
+  displayName: Third-party
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: mcb-portal-dns
+  namespace: monitoring
+spec:
+  type: dns
+  displayName: MCB Portal DNS
+  parentRef:
+    name: third-party
+  interval: 60
+  retryInterval: 60
+  maxRetries: 1
+  dns:
+    # no AAAA record
+    hostname: portal.multi-circuit-boards.eu
+    resolveType: A
+    resolveServer: "2606:4700:4700::1111,1.1.1.1"
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: mcb-portal
+  namespace: monitoring
+  labels:
+    uptime.renner.uno/status-page-section: third-party
+spec:
+  type: http
+  displayName: MCB Portal
+  parentRef:
+    name: third-party
+  interval: 60
+  retryInterval: 60
+  maxRetries: 1
+  timeout: 15
+  http:
+    # root 302s to / to set a session cookie; do not follow
+    url: https://portal.multi-circuit-boards.eu/
+    acceptedStatusCodes: ["200-299", "302"]
+    maxRedirects: 0
+    expiryNotification: true
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: mcb-tech-dns
+  namespace: monitoring
+spec:
+  type: dns
+  displayName: MCB Technician Portal DNS
+  parentRef:
+    name: third-party
+  interval: 60
+  retryInterval: 60
+  maxRetries: 1
+  dns:
+    # no AAAA record
+    hostname: tech.multi-circuit-boards.eu
+    resolveType: A
+    resolveServer: "2606:4700:4700::1111,1.1.1.1"
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: mcb-tech
+  namespace: monitoring
+  labels:
+    uptime.renner.uno/status-page-section: third-party
+spec:
+  type: http
+  displayName: MCB Technician Portal
+  parentRef:
+    name: third-party
+  interval: 60
+  retryInterval: 60
+  maxRetries: 1
+  timeout: 15
+  http:
+    url: https://tech.multi-circuit-boards.eu/
+    acceptedStatusCodes: ["200-299"]
+    expiryNotification: true
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: mcb-www-dns
+  namespace: monitoring
+spec:
+  type: dns
+  displayName: MCB Website DNS
+  parentRef:
+    name: third-party
+  interval: 60
+  retryInterval: 60
+  maxRetries: 1
+  dns:
+    # no AAAA record
+    hostname: www.multi-circuit-boards.eu
+    resolveType: A
+    resolveServer: "2606:4700:4700::1111,1.1.1.1"
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: mcb-www
+  namespace: monitoring
+  labels:
+    uptime.renner.uno/status-page-section: third-party
+spec:
+  type: http
+  displayName: MCB Website
+  parentRef:
+    name: third-party
+  interval: 60
+  retryInterval: 60
+  maxRetries: 1
+  timeout: 15
+  http:
+    # 301 to /index.html, followed
+    url: https://www.multi-circuit-boards.eu/
+    acceptedStatusCodes: ["200-299"]
+    expiryNotification: true
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: turm1388-dns
+  namespace: monitoring
+spec:
+  type: dns
+  displayName: Wohnen im Turm DNS
+  parentRef:
+    name: third-party
+  interval: 60
+  retryInterval: 60
+  maxRetries: 1
+  dns:
+    hostname: turm1388.de
+    resolveType: AAAA
+    resolveServer: "2606:4700:4700::1111,1.1.1.1"
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: turm1388
+  namespace: monitoring
+  labels:
+    uptime.renner.uno/status-page-section: third-party
+spec:
+  type: http
+  displayName: Wohnen im Turm
+  parentRef:
+    name: third-party
+  interval: 60
+  retryInterval: 60
+  maxRetries: 1
+  timeout: 15
+  http:
+    url: https://turm1388.de/
+    acceptedStatusCodes: ["200-299"]
+    expiryNotification: true

kubernetes/apps/monitoring/kustomization.yaml

@@ -17,6 +17,7 @@ resources:
   - smartctl-exporter.yaml
   - intel-gpu-exporter.yaml
   - dashboards/
+  - kumamonitors.yaml
 # prometheusrule-garage.yaml lives in ./monitoring-rules/ and is applied by a
 # separate Flux Kustomization that dependsOn `monitoring` — otherwise the
 # server-side dry-run of the PrometheusRule fails on a fresh cluster

kubernetes/apps/music-assistant/kumamonitors.yaml

@@ -0,0 +1,77 @@
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: music
+  namespace: music-assistant
+  labels:
+    uptime.renner.uno/status-page-section: services
+spec:
+  type: group
+  displayName: Music Assistant
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: music-dns
+  namespace: music-assistant
+spec:
+  type: dns
+  displayName: Music Assistant DNS
+  parentRef:
+    name: music
+  interval: 60
+  retryInterval: 60
+  maxRetries: 1
+  dns:
+    # cluster services have no own record; they resolve through the *.renner.uno wildcard
+    hostname: music.renner.uno
+    resolveType: CNAME
+    resolveServer: "2606:4700:4700::1111,1.1.1.1"
+    conditions:
+      - operator: equals
+        value: proxy.renner.uno
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: music-http
+  namespace: music-assistant
+spec:
+  type: http
+  displayName: Music Assistant HTTP
+  parentRef:
+    name: music
+  interval: 60
+  retryInterval: 60
+  maxRetries: 1
+  timeout: 10
+  http:
+    # reachable: any answer from the backend below 5xx, redirects not followed
+    url: https://music.renner.uno/
+    acceptedStatusCodes: ["200-499"]
+    maxRedirects: 0
+    expiryNotification: true
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: music-info
+  namespace: music-assistant
+spec:
+  type: json-query
+  displayName: Music Assistant Server
+  parentRef:
+    name: music
+  interval: 60
+  retryInterval: 60
+  maxRetries: 1
+  timeout: 10
+  http:
+    # unauthenticated server info
+    url: https://music.renner.uno/info
+    acceptedStatusCodes: ["200-299"]
+    expiryNotification: true
+  jsonQuery:
+    expression: $exists(server_version)
+    operator: "=="
+    expected: "true"

kubernetes/apps/music-assistant/kustomization.yaml

@@ -6,3 +6,4 @@ resources:
   - configmap-net-reconcile.yaml
   - deployment.yaml
   - ingress.yaml
+  - kumamonitors.yaml

kubernetes/apps/navidrome/kumamonitors.yaml

@@ -0,0 +1,153 @@
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: navidrome
+  namespace: navidrome
+  labels:
+    uptime.renner.uno/status-page-section: services
+spec:
+  type: group
+  displayName: Navidrome
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: navidrome-dns
+  namespace: navidrome
+spec:
+  type: dns
+  displayName: Navidrome DNS
+  parentRef:
+    name: navidrome
+  interval: 60
+  retryInterval: 60
+  maxRetries: 1
+  dns:
+    # cluster services have no own record; they resolve through the *.renner.uno wildcard
+    hostname: navidrome.renner.uno
+    resolveType: CNAME
+    resolveServer: "2606:4700:4700::1111,1.1.1.1"
+    conditions:
+      - operator: equals
+        value: proxy.renner.uno
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: navidrome-http
+  namespace: navidrome
+spec:
+  type: http
+  displayName: Navidrome HTTP
+  parentRef:
+    name: navidrome
+  interval: 60
+  retryInterval: 60
+  maxRetries: 1
+  timeout: 10
+  http:
+    # reachable: any answer from the backend below 5xx, redirects not followed
+    url: https://navidrome.renner.uno/
+    acceptedStatusCodes: ["200-499"]
+    maxRedirects: 0
+    expiryNotification: true
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: navidrome-subsonic
+  namespace: navidrome
+spec:
+  type: json-query
+  displayName: Navidrome Subsonic API
+  parentRef:
+    name: navidrome
+  interval: 60
+  retryInterval: 60
+  maxRetries: 1
+  timeout: 10
+  http:
+    # ungated Subsonic path; without credentials it answers with a typed error
+    url: https://navidrome.renner.uno/rest/ping.view?f=json
+    acceptedStatusCodes: ["200-299"]
+    expiryNotification: true
+  jsonQuery:
+    expression: "`subsonic-response`.type"
+    operator: "=="
+    expected: "navidrome"
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: lidarr
+  namespace: navidrome
+  labels:
+    uptime.renner.uno/status-page-section: services
+spec:
+  type: group
+  displayName: Lidarr
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: lidarr-dns
+  namespace: navidrome
+spec:
+  type: dns
+  displayName: Lidarr DNS
+  parentRef:
+    name: lidarr
+  interval: 60
+  retryInterval: 60
+  maxRetries: 1
+  dns:
+    # cluster services have no own record; they resolve through the *.renner.uno wildcard
+    hostname: lidarr.renner.uno
+    resolveType: CNAME
+    resolveServer: "2606:4700:4700::1111,1.1.1.1"
+    conditions:
+      - operator: equals
+        value: proxy.renner.uno
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: lidarr-http
+  namespace: navidrome
+spec:
+  type: http
+  displayName: Lidarr HTTP
+  parentRef:
+    name: lidarr
+  interval: 60
+  retryInterval: 60
+  maxRetries: 1
+  timeout: 10
+  http:
+    # reachable: any answer from the backend below 5xx, redirects not followed
+    url: https://lidarr.renner.uno/
+    acceptedStatusCodes: ["200-499"]
+    maxRedirects: 0
+    expiryNotification: true
+---
+apiVersion: uptime.renner.uno/v1alpha1
+kind: KumaMonitor
+metadata:
+  name: lidarr-gate
+  namespace: navidrome
+spec:
+  type: keyword
+  displayName: Lidarr Login
+  parentRef:
+    name: lidarr
+  interval: 60
+  retryInterval: 60
+  maxRetries: 1
+  timeout: 20
+  http:
+    # fully behind the Authentik gate; asserts the login page the redirect chain ends on
+    url: https://lidarr.renner.uno/
+    acceptedStatusCodes: ["200-299"]
+    expiryNotification: true
+  keyword:
+    keyword: "<title>authentik</title>"