Skip to main content
The migrate command helps upgrade projects from older isle-site-template layouts. These helpers are one-time operations — run them on a branch, review the output, then commit.

merge-compose-profiles

Merge Compose profile variants into single service definitions and extract Traefik labels into separate configuration files. Supports migration from the legacy isle-site-template format that used -dev/-prod service pairs. The format is detected automatically.
sitectl isle migrate merge-compose-profiles
FlagDefaultDescription
-f, --forcefalseOverwrite the output file if it already exists.
-i, --inputdocker-compose.ymlInput Compose file.
-o, --outputdocker-compose.ymlOutput Compose file.

When to use this

The legacy format used -dev/-prod service pairs in docker-compose.yml. The current format uses a single service definition with Traefik labels in a separate file. Run merge-compose-profiles to convert the old layout automatically, then review the diff before committing.