app-catalog-felhom.eu/REPORT.md

REPORT — healthcheck fixes (komga + gitea) — 2026-06-22, unattended test campaign

Two healthcheck fixes of the same class, found + verified live on guest 9201 during the unattended test campaign (full evidence in felhom-controller/TEST-REPORT.md):

• gitea (17e00b7): docker HC + .felhom.yml probe /api/v1/version (404 until install-lock) → /api/healthz (200 while serving); start_period 30s→90s. Surfaced during the Phase-2 deploy sweep; validated: re-sync → redeploy → docker inspect: healthy.
• komga (3faa5ae, 9b066de): detailed below.

What changed

Repointed komga's health probe from the auth-gated /api/v1/actuator/health (HTTP 401) to the unauthenticated /actuator/health (HTTP 200), in both places that probe komga:

• templates/komga/docker-compose.yml — the Docker healthcheck (curl -f).
• templates/komga/.felhom.yml — the controller-side healthcheck.checks[].path (this is what drives the dashboard "Nem egészséges" badge and route publishing).

Why (diagnosed live on guest 9201)

• The running container's docker HC curl -f http://localhost:25600/api/v1/actuator/health exited 22 (HTTP 401) → container reported unhealthy for 18h despite serving normally on :25600.
• The controller probe logged Health probe komga: API GET :25600/api/v1/actuator/health → expected 200, got 401.
• Endpoint probe matrix (wget inside the image): /, /actuator/health, /api/v1/oauth2/providers, /login all → 200; only /api/v1/actuator/health → 401. Komga's Spring actuator is served unauthenticated off the /api/v1 prefix.
• The gotson/komga:1.20.0 image ships curl (verified /usr/bin/curl), so the probe tool is unchanged.

Validation (end-to-end through the real UI + server pipeline)

1. Committed + pushed to app-catalog main (3faa5ae docker HC, 9b066de controller probe).
2. GUI "Sablonok frissítése" → controller git-sync: logs Updated komga/docker-compose.yml + Updated komga/.felhom.yml; catalog-cache + live stack /opt/docker/stacks/komga/docker-compose.yml both updated to /actuator/health.
3. GUI "Frissítés" → POST /api/stacks/komga/update 200 → docker compose up -d --remove-orphans → container recreated (StartedAt 2026-06-22T13:09:50Z), "Stack komga updated successfully (4.2s)".
4. Result: docker ps → komga Up (healthy), HC now /actuator/health; controller "Health probes: ok"; dashboard card flipped to Fut and the "URL nem elérhető – útvonal nincs publikálva" warning cleared.