+0
日增长
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
#165SIGINT/SIGTERM ignored during startup phase & healthcheck wait in foreground up5 comments · 2026-11-02#67File `-f` option should be top-level like Docker Compose4 comments · 2026-04-06#140Environment variables interpolation not supported3 comments · 2026-07-23#38compose down doesn't support named containers (or custom named containers)3 comments · 2025-12-01#48Support `include`2 comments · 2026-01-29#43add run subcommand2 comments · 2025-12-09#7container compose doesn't support extends2 comments · 2025-09-28#137Missing features and issues when trying to work with `@wordpress/env` (wp-env)1 comments · 2026-07-16
Discussions
#54The state of Container-Compose (NOT DEPRECATED)1 comments · 2026-02-07#12Welcome to Container-Compose Discussions!0 comments · 2025-10-12
Latest release
1.2.0 1.2.0 2026-09-21What'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