From 43b8307e54b2d7ab2b28f488f30c08f3f5f47565 Mon Sep 17 00:00:00 2001 From: William Mantly Date: Sun, 2 Aug 2026 13:13:50 -0400 Subject: [PATCH] docs: note docker compose v1 incompatibility --- README.md | 3 +-- docs/quickstart.md | 3 +-- 2 files changed, 2 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index 632abfd..09bf931 100644 --- a/README.md +++ b/README.md @@ -140,8 +140,7 @@ Optional extra ports (only if you need them): ### 4. Docker + Docker Compose -Any recent Docker with Compose — the v2 plugin (`docker compose`) or the v1 -standalone (`docker-compose`) both work. +You must use the modern Docker Compose v2 plugin (`docker compose`). The older v1 standalone (`docker-compose`) is not compatible with the BuildKit images generated by this suite and will fail with a `ContainerConfig` KeyError during deployment. --- diff --git a/docs/quickstart.md b/docs/quickstart.md index 633bbfc..65da8f5 100644 --- a/docs/quickstart.md +++ b/docs/quickstart.md @@ -12,8 +12,7 @@ description: Step-by-step first run for theta-suite — prerequisites, setup.env ## Prerequisites -- A Linux host with **Docker** + **Docker Compose** (the v2 plugin `docker - compose` or the v1 standalone `docker-compose` both work). +- A Linux host with **Docker + Docker Compose** (you must use the modern `docker compose` v2 plugin; the older `docker-compose` v1 standalone will fail on BuildKit images). - Two hostnames that resolve to the host: one for the SSO UI (your `stack.ssoHost`), one for the proxy mgmt UI (your `stack.proxyHost`). On a real network add DNS records; for a local try, add them to `/etc/hosts`.