11ai Docker environment
Version baseline: Current stable Docker tooling: Engine 29.x (29.6.2 at this review), Compose v5, and the matching current BuildKit/containerd supplied by the installation. Inspect each component independently because Docker Desktop, Engine, Compose, Buildx, and the API do not share one version.
Establish what Docker endpoint the CLI is targeting before operating on resources. Keep the first pass read-only and report exact command output or the relevant error.
Workflow
Identify the working directory and operating system when it affects paths or Compose behavior.
Run the smallest useful checks:
docker version docker info docker context show docker context ls docker compose version docker psClassify the result as a CLI problem, daemon problem, context problem, permission problem, or Compose problem.
Recommend the least invasive next step. Do not repair, restart, install, or switch contexts unless the user asks for that action.
Interpretation
docker: command not foundmeans the CLI is missing or not onPATH; do not assume a package manager or installation method.- A client version with no server response usually means the daemon is unavailable, the selected context is unreachable, or access is denied.
- A non-default context changes which Docker daemon receives commands. Confirm the target before any state-changing command.
docker infocan fail even when the CLI is installed; quote the daemon error instead of reporting Docker as wholly absent.docker compose versionis a separate capability check. Preferdocker composewhen available and do not silently fall back to the legacydocker-composebinary.- A permission error is not permission to recommend
sudoautomatically. Explain the tradeoff and ask before changing group membership or using elevated access.
Optional evidence
When the first checks are inconclusive, collect only relevant details such as docker context inspect NAME, docker system df, or the platform's service status command. Avoid printing environment variables that may contain credentials. Redact tokens, registry credentials, socket paths that reveal sensitive infrastructure, and unrelated logs.
Reporting
End with the active context, whether the daemon answered, whether Compose is available, and the next safe action. If a context switch or daemon restart is needed, give the exact command but wait for explicit approval before running it.