Robots Atlas>ROBOTS ATLAS
Infrastructure

Apple Container

2025ActivePublished: 18 November 2026Updated: 18 November 2026Published
Key innovation
Runs OCI containers on macOS with one lightweight virtual machine per container instead of a single shared Docker Desktop-style VM, using Apple's native Virtualization framework on Apple silicon.
Category
Infrastructure
Abstraction level
System
Operation level
DeploymentAgent runtimeTooling
Use cases
Isolated sandbox for executing AI agent code on macOSRunning OCI/Docker images locally on Apple siliconReproducible Linux development environments on a MacIsolating untrusted LLM-generated codeBuilding and publishing OCI images from macOS

How it works

Each `container run` boots a minimal Linux virtual machine using Apple's Virtualization framework (on Apple silicon). Inside the VM runs vminitd — a small init system that is the first process and exposes a gRPC API over vsock. Thanks to an optimized Linux kernel configuration and a minimal root filesystem (ext4), containers reach sub-second start times. OCI-format images are pulled from standard registries; each container can be given a dedicated IP address, which removes the need for port forwarding. linux/amd64 containers can run on Apple silicon via Rosetta 2. The service is started with `container system start`. Requirements: a Mac with Apple silicon and macOS 26 or later; the Containerization framework is tested from kernel version 6.14.9, and users can supply their own kernel.

Problem solved

macOS cannot natively run Linux containers, and the dominant solution (Docker Desktop) runs all containers inside a single shared virtual machine, which weakens isolation between them. Apple Container solves this by giving each container its own lightweight VM with a dedicated IP address and sub-second start times. For AI systems and agents this means a strong, OS-native sandbox for safely running untrusted or generated code on Apple silicon Macs.

Components

container (CLI)Command-line interface for creating, running, and managing OCI containers and images.

The main user entry point; commands such as `container run` and `container system start`.

Containerization (Swift package)Low-level management of containers, OCI images, and processes; the foundation the CLI is built on.

A Swift package providing APIs for OCI images, registries, ext4 filesystems, Netlink sockets, and building an optimized Linux kernel.

Lightweight virtual machine (Virtualization.framework)Isolated execution environment — one dedicated VM per container.

On Apple silicon it uses Apple's Virtualization framework; each container gets its own VM with an optional dedicated IP.

vminitdMinimal init system that runs as the first process inside the VM.

Exposes a gRPC API over vsock to manage the container process lifecycle.

Evolution

2025
Apple open-sources container and Containerization
Inflection point

Apple releases the `container` tool and the Containerization Swift package under Apache-2.0, introducing a one-lightweight-VM-per-container model on Apple silicon.

Hyperparameters (configurable axes)

VM resources (CPU/RAM)High

CPU and memory allocation for the container's virtual machine.

Architecture emulation (Rosetta 2)Medium

Running linux/amd64 images on Apple silicon via Rosetta 2.

Container Linux kernelMedium

Ability to supply a custom Linux kernel; tested from version 6.14.9.