Mcrich23 /Container-Compose

A docker-compose like tool for Apple Container

★ 1,002⑂ 60👁 10⑃ 123● 62▤ 17
SwiftApache-2.0Created 2025-06-18
Download: 1.2.01.2.0 ↓1.2.02026-09-21
+0
Daily
1,002
stars
60
forks
10
watchers
123
prs
62
issues
17
releases

README

Container-Compose

Container-Compose brings (limited) Docker Compose support to Apple Container, allowing you to define and orchestrate multi-container applications on Apple platforms using familiar Compose files. This project is not a Docker or Docker Compose wrapper but a tool to bridge Compose workflows with Apple's container management ecosystem.

 [!Note]
 Use macOS 26.0 or later for custom networks and container-to-container networking.

 Features

- Compose file support: Parse and interpret docker-compose.yml files to configure Apple Containers.
- Apple Container orchestration: Launch and manage multiple containerized services using Apple’s native container runtime.
- Environment configuration: .env supplies interpolation values. Service env_file entries supply container variables, with later files taking precedence; explicit environment values override them.
- Service dependencies: Specify service dependencies and startup order.
- Volume and network mapping: Map data and networking as specified in Compose files to Apple Container equivalents.
- Extensible: Designed for future extension and customization.

 Compose support status

- Supported: The listed behavior is implemented without the limitations described for partial support.
- Partially supported: Some syntax or behavior is missing.
- Unsupported: Not implemented in Container-Compose.

 Commands

Command support includes both available behavior and known gaps. A command being present does not mean it behaves like Docker Compose in every case.

| Command | Support | What works | What is missing or limited |
| --- | --- | --- | --- |
| up | Partial | Starts enabled or explicitly named services and their dependencies in dependency order. Attempts to stop and remove existing selected containers before starting replacements. Supports detached operation, foreground output, rebuilding with -b/--build, and --no-cache. | Foreground signal handling is installed only after service startup, leaving startup and health-check waits uncovered. Use down to stop them. Independent services start sequentially. --no-cache only affects a build that runs; use --build to rebuild an existing local image. Cleanup errors are printed and startup continues. Other YAML limits are listed below. |
| down | Partial | Attempts to stop selected project containers using stop_grace_period. | Does not remove containers, networks or named volumes. Uses the shared profile and dependency selection: inactive-profile services are included when explicitly named or required by a selected service, but otherwise skipped. Container lookup uses candidate names rather than checking project labels. Stop errors are printed and do not fail the command; YAML stop_signal is not applied. |
| build | Partial | Builds selected services and their buildable dependencies. Supports --no-cache, service platform including variants such as linux/arm64/v8, dictionary build arguments, custom Dockerfiles and build.target. Tags images with image or :

Top issues

Discussions

Latest release

1.2.0 1.2.0 2026-09-21
What's Changed
 fix: tolerate env-var placeholders and quoted scalars in deploy.replicas decoding by @mvanhorn in https://github.com/Mcrich23/Container-Compose/pull/129
 Add shared ComposeProjectOptions by @adrum in https://github.com/Mcrich23/Container-Compose/pull/138
 feat: error on unknown service name in up instead of hanging by @OrtegaMatias in https://github.com/Mcrich23/Container-Compose/pull/139
 fix: make Main the root command instead of a passthrough wrapper by @subpop in https://github.com/Mcrich23/Container-Compose/pull/149
 feat: add dependencyLevels scheduler for parallel up (12

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON