GitHub - apple/container: A tool for creating and running Linux containers using lightweight virtual machines on a Mac. It is written in Swift, and optimized for Apple silicon.
container is a Swift tool that runs OCI-compatible Linux containers as lightweight VMs on macOS 26 Apple Silicon. It lets you pull, build, push, and run standard container images, and provides scripts for install, upgrade, downgrade, and uninstall. The project uses the Containerization Swift package and is in active development with a stable API only within patch versions.
- Apple's own tool runs standard OCI containers as lightweight Linux VMs directly on Apple silicon Macs, using the virtualization framework instead of Docker-style shared-kernel containers.
- Requires macOS 26 specifically, and it's built on Apple's open-source Containerization Swift package.
- Still 0.x/actively developed, so breaking changes can happen between minor versions—only patch releases are guaranteed stable.
- Comes with full lifecycle tooling (install/upgrade/downgrade/uninstall scripts, CLI for pulling/building/pushing images) rather than being just a proof-of-concept.
Container is a Swift-based CLI tool that turns macOS 26 on Apple silicon into a lightweight Linux VM host. It handles OCI-compatible images—pull from any registry, run them locally, build your own and push back. Under the hood it uses Apple’s virtualization framework and the open-source Containerization Swift package to manage images, containers and networking without heavyweight dependencies.
You install it by downloading the signed .pkg from GitHub Releases, double-clicking, then entering your admin password so files land under /usr/local. Once installed, start the background service with `container system start`. Upgrades or rollbacks happen through an included script: stop the service with `container system stop`, then run `/usr/local/bin/update-container.sh` for the latest release or specify a version for earlier builds. An uninstall script lives at `/usr/local/bin/uninstall-container.sh`; add `-k` to keep your data or `-d` to wipe it.
The repo bundles docs for a guided tour—build, run and publish a simple web server image—plus a full command reference and API docs. You’ll find a BUILDING guide if you want to compile from source. The project sits at version 0.x, so expect possible breaking changes between minor releases; patch updates stay compatible. Contributions follow the main contributing guide on GitHub.