Compose Support

Audience

This page is for developers, platform maintainers, and operators importing existing Compose applications into AiOS.

Goal and Scope

AiOS supports Compose import, not full Docker Compose compatibility.

Core Concepts

Three statuses

supported: convert and continue
warn: continue, but expose semantic drift clearly
blocked: fail immediately

Strict mode

When strict=true, any warn also becomes a failure.

Standard Workflow

parse the Compose file
evaluate fields against the support matrix
generate a supported / warn / blocked report
continue into AppSpec conversion only after validation passes

Current Control-Plane API Freeze

The current /api/v1/compose/import freeze covers matrix evaluation and import reporting first. This round does not require that route to own raw YAML upload, full AppSpec persistence, or deployment advancement.

Planned CLI Examples (Not Yet Implemented)

The repository does not currently ship these Compose import commands. The executable surface frozen today is POST /api/v1/compose/import.

aios app up --from-compose ./compose.yaml
aios app up --from-compose ./compose.yaml --strict

​Compose Support

​Audience

​Goal and Scope

​Core Concepts

​Three statuses

​Strict mode

​Standard Workflow

​Current Control-Plane API Freeze

​Planned CLI Examples (Not Yet Implemented)

​Related Pages