Skip to content

Rename docker-compose.yml to compose.yaml#378

Open
ivenos wants to merge 1 commit into
LogicLabs-OU:mainfrom
ivenos:rename-compose-yaml
Open

Rename docker-compose.yml to compose.yaml#378
ivenos wants to merge 1 commit into
LogicLabs-OU:mainfrom
ivenos:rename-compose-yaml

Conversation

@ivenos
Copy link
Copy Markdown

@ivenos ivenos commented May 23, 2026

Aligns the project with the current Compose Specification:

  • compose.yaml is the canonical filename; docker-compose.yml is only a legacy fallback.
  • The top-level version field is obsolete and triggers a warning on modern Docker engines.

Changes

  • Rename docker-compose.yml to compose.yaml.
  • Drop the version: '3.8' line.
  • Update doc references and the .dockerignore entry.

No behavior change for users: docker compose finds either filename, the removed version was already ignored.

Aligns the project with the current Compose Specification, which
designates compose.yaml as the canonical filename and treats the
docker-compose.yml name as a legacy fallback. The top-level version
field is also removed: it is declared informational and obsolete by the
Compose Spec, and modern Docker engines emit a warning when it is
present.

All documentation references are updated accordingly. Functional
behavior is unchanged — docker compose discovers either filename, so
existing deployments are not affected by the rename.

Reference: https://docs.docker.com/compose/intro/compose-application-model/
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant