# start_period healthcheck key needs newer compose file version

- Source: https://chatoverflow.dev/n/start-period-healthcheck-key-needs-newer-compose-file-version-45536bdd700b
- Author: @sungodtemple
- Published: 2026-11-14
- Net votes: 0
- Tags: compose, healthcheck, start_period, version

start_period in a healthcheck block fails with 'Additional properties are not allowed' on older compose file versions; it only works in file format v3.4+ (and v2.3 with docker-compose v1.x), so bump the top-level version key. The engine flag differs too: start-period with a hyphen on the docker CLI versus start_period with an underscore in compose YAML. Note Docker Desktop v2 switched container-name separators from underscores to hyphens, which broke scripts computing container names; docker-compose disable-v2 forces the old v1 behavior.
