# Benefits of Using BuildKit for Image Building with Apple Container > Discover the benefits of using BuildKit for accelerated OCI image building with Apple Container. Enjoy an isolated, cache-optimized build environment that keeps your host system clean. - Repository: [Apple/container](https://github.com/apple/container) - Tags: best-practices - Published: 2026-06-28 --- **BuildKit delivers an isolated, resource-controlled, and cache-optimized build environment that accelerates OCI image creation while maintaining a clean host system.** The `container` CLI tool by Apple leverages BuildKit as its underlying build engine, executing it inside a dedicated container within a lightweight VM as described in [`docs/technical-overview.md`](https://github.com/apple/container/blob/main/docs/technical-overview.md). This architecture provides developers with significant performance, security, and cross-platform advantages when building container images on macOS. ## Isolated Build Environment BuildKit runs as a **builder container** inside the `container` tool's lightweight VM, completely isolating the image build process from the host macOS system. This design prevents build artifacts, temporary files, and dependencies from polluting the local environment. According to the [`command-reference.md`](https://github.com/apple/container/blob/main/command-reference.md) at line 126, the builder "runs in isolation using BuildKit", ensuring that even complex multi-stage builds cannot affect host system state or leave behind orphaned resources. ## Resource Control and Limits The `container` CLI allows precise capping of compute resources for the BuildKit instance, preventing resource-intensive builds from monopolizing your machine. ### Configuring CPU and Memory Constraints The builder accepts `--cpus` and `--memory` parameters documented in [`docs/command-reference.md`](https://github.com/apple/container/blob/main/docs/command-reference.md) under *Builder Management* (lines 106-118). These constraints are enforced when starting the builder: ```bash container builder start --cpus 4 --memory 8g ``` In [`Sources/ContainerCommands/Builder/BuilderStart.swift`](https://github.com/apple/container/blob/main/Sources/ContainerCommands/Builder/BuilderStart.swift), the implementation configures these limits during container creation, ensuring the BuildKit daemon respects the specified boundaries throughout the build lifecycle. ## Intelligent Caching and Performance BuildKit automatically caches intermediate layers and executes independent Dockerfile instructions in parallel, dramatically reducing rebuild times. ### Layer Caching and Incremental Builds The [`BuilderStart.swift`](https://github.com/apple/container/blob/main/BuilderStart.swift) implementation (lines 94-174) mounts a `tmpfs` for the build workspace and reuses cached blobs when image, CPU, memory, environment, or DNS settings remain unchanged. This means subsequent builds only re-execute steps where dependencies have changed. ### Parallel Execution and Remote Caching While the CLI does not expose explicit parallelism flags, the underlying BuildKit daemon started by `container builder start` enables concurrent execution of independent build steps by default. Additionally, the builder image is fetched with `ClientImage.fetch` and layers are unpacked once per builder lifecycle, making cached data readily available to subsequent builds. This design supports remote cache registries, allowing teams to share build artifacts and avoid redundant work across different machines. ## Cross-Platform Build Support For developers working on Apple Silicon hardware, BuildKit supports transparent cross-architecture builds through Rosetta and QEMU integration. The [`BuilderStart.swift`](https://github.com/apple/container/blob/main/BuilderStart.swift) file (lines 196-202) handles the `--enable-qemu` flag based on the `rosetta` parameter, allowing x86 images to build seamlessly on ARM64 Macs. This capability is managed automatically when starting the builder: ```bash # Enable Rosetta support for x86 builds container builder start --rosetta ``` ## Consistent Builder Lifecycle All builder operations—`start`, `status`, `stop`, and `delete`—function as thin wrappers around the same BuildKit container, providing a predictable workflow. The [`Sources/ContainerCommands/Builder/BuilderDelete.swift`](https://github.com/apple/container/blob/main/Sources/ContainerCommands/Builder/BuilderDelete.swift) implementation enforces safe deletion practices, requiring the builder to be stopped unless the `--force` flag is provided. This consistency is documented in [`docs/command-reference.md`](https://github.com/apple/container/blob/main/docs/command-reference.md) under *Builder Management* (lines 100-152). ## Practical BuildKit Commands Start and manage your BuildKit builder using these examples: ```bash # Start a BuildKit builder with custom resources container builder start --cpus 4 --memory 8g # Inspect the builder status (human-readable table) container builder status # Build an OCI image using the builder container image build -t myapp:latest . # Stop the builder when done container builder stop # Force-delete a stray builder after a crash container builder delete --force ``` Each command routes through the BuildKit container that `container` spins up automatically, providing a unified interface to the underlying build engine. ## Summary - **Process isolation** keeps the host environment clean by running all builds inside a dedicated BuildKit container within a lightweight VM. - **Resource limits** (`--cpus` and `--memory`) prevent builds from overwhelming host system resources. - **Automatic caching** of intermediate layers and incremental builds significantly speeds up rebuilds when using the same configuration. - **Parallel execution** of independent Dockerfile instructions reduces overall build time without manual configuration. - **Cross-architecture support** via Rosetta and QEMU enables x86 image builds on Apple Silicon hardware. - **Unified lifecycle management** provides consistent commands for starting, monitoring, and cleaning up builder resources. ## Frequently Asked Questions ### What is BuildKit and why does Apple Container use it? BuildKit is an advanced, open-source build engine that replaces the traditional Docker build system. Apple Container uses BuildKit as its underlying engine because it provides superior performance through parallel execution, intelligent caching, and better resource isolation compared to legacy builders, as implemented in [`Sources/ContainerCommands/BuildCommand.swift`](https://github.com/apple/container/blob/main/Sources/ContainerCommands/BuildCommand.swift). ### How do I limit CPU and memory for image builds? Pass the `--cpus` and `--memory` flags when starting the builder: `container builder start --cpus 4 --memory 8g`. These constraints are enforced by the BuildKit container configuration in [`BuilderStart.swift`](https://github.com/apple/container/blob/main/BuilderStart.swift), ensuring the build process cannot exceed the specified resources. ### Can I build x86 images on Apple Silicon Macs? Yes. The `container` CLI supports cross-architecture builds through the `--rosetta` flag. When enabled, [`BuilderStart.swift`](https://github.com/apple/container/blob/main/BuilderStart.swift) configures BuildKit with `--enable-qemu` to handle x86 instruction translation transparently, allowing you to build Intel-based images on ARM64 hardware without manual QEMU setup. ### How does BuildKit caching work in Container? BuildKit caches intermediate layers automatically when the build configuration (image, CPU, memory, environment variables, and DNS settings) remains unchanged. The implementation in [`BuilderStart.swift`](https://github.com/apple/container/blob/main/BuilderStart.swift) mounts a `tmpfs` workspace and reuses cached blobs, meaning subsequent builds only re-execute steps where dependencies have actually changed.