Docker Compose v1 (docker-compose) → Docker Compose v2 (docker compose)
easyDocker Compose v1 (Python-based) is EOL. v2 (Go-based) is a Docker CLI plugin. Command changes from docker-compose to docker compose (with space).
Docker Desktop includes v2. For Linux: install docker-compose-plugin package.
docker compose version
Replace docker-compose with docker compose in all Makefiles, CI configs, and shell scripts.
version: field in docker-compose.yml is now optional and ignored in v2. Can be removed.
What this migration involves
Moving from Docker Compose v1 (docker-compose) to Docker Compose v2 (docker compose) is rated easy and takes about 0.5-1h on a typical project. The guide breaks it into 4 steps, 1 of which ship with runnable commands and 1 with a verification check.
FAQ
How long does migrating from Docker Compose v1 (docker-compose) to Docker Compose v2 (docker compose) take?
Around 0.5-1h for a typical project — 4 steps, difficulty rated easy, 1 of them with copy-paste commands.
Is moving from Docker Compose v1 (docker-compose) to Docker Compose v2 (docker compose) reversible?
No reverse guide is tracked yet, so treat this as a one-way move and keep a full export of your Docker Compose v1 (docker-compose) data before you start.
What does Docker Compose v2 (docker compose) cost compared to Docker Compose v1 (docker-compose)?
Pricing for both tools is contact-based or not tracked yet.