Skip to content
Home / Migrations / Docker Compose v1 (docker-compose)Docker Compose v2 (docker compose)

Docker Compose v1 (docker-compose) Docker Compose v2 (docker compose)

easy

Docker Compose v1 (Python-based) is EOL. v2 (Go-based) is a Docker CLI plugin. Command changes from docker-compose to docker compose (with space).

Estimated: 0.5-1h · 4 steps
Progress0%
Step 1: Verify v2 is installed

Docker Desktop includes v2. For Linux: install docker-compose-plugin package.

docker compose version
Step 2: Update scripts

Replace docker-compose with docker compose in all Makefiles, CI configs, and shell scripts.

Step 3: Check compose file version

version: field in docker-compose.yml is now optional and ignored in v2. Can be removed.

Step 4: Test
docker compose up, docker compose down, docker compose build all work. Volumes and networks persist.