This repository contains examples that show you how to use container and Containerization to build, run, and develop with Linux containers on your Mac.
containeris a tool that you can use to create and run Linux containers as lightweight virtual machines on your Mac. It's written in Swift, and optimized for Apple silicon.- Containerization is the Swift package that
containeruses for low-level container, image, and process management. You can use it to add Linux container support to your own applications.
| Example | Description |
|---|---|
| container-machine-vscode | Develop Linux applications in a container machine with Visual Studio Code and its SSH remote development extension. |
| container-cluster-gateway | Run a three-tier web app on a local Kubernetes cluster with container cluster, and reach it from your browser through a gateway container. |
| container-workflows-lab | Take a Swift server app with Postgres through three workflows: verify it on Linux with container machine, build and run an image with container, and deploy it locally with container cluster. |
| containerization-hello | Run a simple Linux container in about 50 lines of Swift with the Containerization package: fetch a kernel, then create and start a container. |
| containerization-sandboxy | Run coding agents such as Claude Code in isolated Linux VMs built with Containerization, with host mounts and a network allowlist. |
Each example has its own README with prerequisites and step-by-step instructions.
If an example doesn't work as described, open an issue in this repository. If the problem is with container or Containerization itself, open an issue in the container or Containerization repository.
Contributions are welcome and encouraged! Read the main contributing guide to get started.
This project follows the Code of Conduct used by Container and Containerization.
See MAINTAINERS.txt.
This project is licensed under the Apache License 2.0.