> ## Documentation Index
> Fetch the complete documentation index at: https://libops-renovate-github-com-libops-sitectl-0-x.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# migrate

> Helpers for upgrading sites from legacy isle-site-template formats.

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.

```bash theme={null}
sitectl isle migrate merge-compose-profiles
```

| Flag           | Default              | Description                                     |
| -------------- | -------------------- | ----------------------------------------------- |
| `-f, --force`  | `false`              | Overwrite the output file if it already exists. |
| `-i, --input`  | `docker-compose.yml` | Input Compose file.                             |
| `-o, --output` | `docker-compose.yml` | Output 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.