title: Docker setup and Compose evidence

scenario:
  id: docker-compose-setup
  surface: docker-podman-hosting
  category: docker-podman-hosting.container-setup
  coverage:
    secondary:
      - docker.compose
      - docker.local-image-setup-script
      - docker.only-first-run-notes
  objective: Link Docker Compose setup e2e coverage to Docker maturity accounting.
  successCriteria:
    - The Docker setup script builds local images, reuses preloaded GHCR images in offline mode, and preserves BuildKit behavior.
    - First-run setup emits Docker-only post-start notes without printing the gateway token.
    - Docker Compose gateway and CLI service command shape stays in sync.
    - Compose service env, token, auth-profile, timezone, and optional env-file defaults stay aligned.
    - Container-side state, config, and workspace paths override host `.env` values.
  docsRefs:
    - docs/install/docker.md
    - docs/help/testing.md
  codeRefs:
    - scripts/docker/setup.sh
    - src/docker-setup.e2e.test.ts
  execution:
    kind: vitest
    path: src/docker-setup.e2e.test.ts
    summary: Vitest e2e coverage for Docker setup script, first-run notes, Compose service shape, and mount/env contracts.