# REPORT — komga healthcheck fix (2026-06-22, unattended test campaign)

## 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.