From fef0a7d0263f6266b2ed70f7cf464b8475cc286d Mon Sep 17 00:00:00 2001 From: sam Date: Fri, 21 Aug 2026 06:20:27 +0000 Subject: [PATCH] docs: troubleshooting row for compose non-default-filename discovery error --- README.md | 1 + 1 file changed, 1 insertion(+) diff --git a/README.md b/README.md index 9a99a19..886d8fc 100644 --- a/README.md +++ b/README.md @@ -77,6 +77,7 @@ The agent re-authenticates and resumes polling. | Symptom | Meaning | |---|---| +| `no configuration file provided: not found` | You ran a follow-up `docker compose logs`/`ps` without `-f docker-compose.agent.yml` — the kit's compose file has a non-default name, so it isn't auto-discovered. Re-run with `-f docker-compose.agent.yml`, or use plain `docker logs onlyscans-agent` (the container itself is fine) | | Container exits ~1 s after start | Bad `AGENT_IDENTITY`, `AGENT_PASSWORD`, or unknown `AGENT_LOCATION` — fatal by design; fix `.env` and recreate | | Agent shows **offline** centrally (`/agents`) | Container down, or no egress to `scan-api.noctools.nz:443` — check `docker logs onlyscans-agent` | | Scans stay queued | Agent online but for a different location, or targets unreachable from the container's network — try the host-network variant |