# Apple Container Documentation: Where to Find Official Guides and API References > Find official Apple Container documentation, guides, and API references directly within the GitHub repository and on the hosted documentation site. Access the latest information for apple container. - Repository: [Apple/container](https://github.com/apple/container) - Tags: api-reference - Published: 2026-06-30 --- **All official apple/container documentation lives inside the GitHub repository under the root [`README.md`](https://github.com/apple/container/blob/main/README.md) and the `docs/` directory, with a generated Swift API reference hosted at https://apple.github.io/container/documentation/.** The apple/container project provides native containerization for macOS using the Apple Virtualization framework. Whether you are building images or managing container lifecycle operations, locating the authoritative apple container documentation within the repository ensures you are referencing the latest CLI flags and architectural patterns implemented in the source code. ## Documentation Locations Inside the Repository Apple maintains all user-facing documentation within the `main` branch of the repository. You can browse the complete documentation tree by navigating to the **`docs/`** folder or reading the root-level files directly. ### Root README and Quick Start The **[`README.md`](https://github.com/apple/container/blob/main/README.md)** file serves as the primary entry point for new users. It contains installation instructions, upgrade procedures, and links to the full API documentation site. According to the source code, this file also includes quick-start links that point to the tutorial content. ### Technical Architecture Overview For developers needing to understand implementation details, **[`docs/technical-overview.md`](https://github.com/apple/container/blob/main/docs/technical-overview.md)** explains how the tool leverages the Apple Containerization Swift package. This document covers the integration with macOS Virtualization and vmnet frameworks, as well as the role of XPC helper processes in the overall architecture. ### Command Reference The **[`docs/command-reference.md`](https://github.com/apple/container/blob/main/docs/command-reference.md)** file serves as the definitive CLI manual. It documents every command including `container run`, `container build`, and `container system` with their respective flags, platform-specific notes, and usage examples. ### Practical Guides and Tutorials Step-by-step instructions reside in **[`docs/how-to.md`](https://github.com/apple/container/blob/main/docs/how-to.md)** and **[`docs/tutorials/start-here.md`](https://github.com/apple/container/blob/main/docs/tutorials/start-here.md)**. The tutorial walks you through building, running, and publishing a simple web-server image, while the how-to guide covers specific tasks like port publishing, networking configuration, and using init images. ### Generated API Documentation The Swift API documentation is automatically generated from source and hosted at **https://apple.github.io/container/documentation/**. This site mirrors the source code API and is linked directly from the root README. ## Key Documentation Files The following files constitute the core documentation set for the repository: - **[`README.md`](https://github.com/apple/container/blob/main/README.md)** — High-level project overview, installation steps, and entry points to other documentation. - **[`docs/technical-overview.md`](https://github.com/apple/container/blob/main/docs/technical-overview.md)** — Architectural deep-dive covering the VM model, security features, and framework integration. - **[`docs/command-reference.md`](https://github.com/apple/container/blob/main/docs/command-reference.md)** — Complete CLI reference with flags and examples. - **[`docs/how-to.md`](https://github.com/apple/container/blob/main/docs/how-to.md)** — Task-oriented recipes for common operations like building images and publishing ports. - **[`docs/tutorials/start-here.md`](https://github.com/apple/container/blob/main/docs/tutorials/start-here.md)** — Beginner-friendly walkthrough for building your first container image. - **[`Package.swift`](https://github.com/apple/container/blob/main/Package.swift)** — The Swift package manifest that defines the container CLI target and its dependencies. ## CLI Examples from the Documentation Below are practical examples extracted directly from [`docs/command-reference.md`](https://github.com/apple/container/blob/main/docs/command-reference.md) demonstrating common container operations. Running a container interactively: ```bash container run -it ubuntu:latest /bin/bash ``` Building an image with multiple tags: ```bash container build -t my-app:latest -t my-app:v1.0.0 . ``` Publishing a port to expose a web server: ```bash container run -d --name web -p 8080:80 nginx:latest ``` Using an init process to reap zombie processes: ```bash container run --init ubuntu:latest my-app ``` ## Summary - The apple/container repository hosts all documentation in the `docs/` folder and root [`README.md`](https://github.com/apple/container/blob/main/README.md), ensuring content stays synchronized with code updates. - Architectural details are found in [`docs/technical-overview.md`](https://github.com/apple/container/blob/main/docs/technical-overview.md), which explains the Virtualization framework and XPC helper process integration. - The complete CLI reference for commands like `container run` and `container build` is located in [`docs/command-reference.md`](https://github.com/apple/container/blob/main/docs/command-reference.md). - Practical tutorials and how-to guides are available in [`docs/tutorials/start-here.md`](https://github.com/apple/container/blob/main/docs/tutorials/start-here.md) and [`docs/how-to.md`](https://github.com/apple/container/blob/main/docs/how-to.md). - Generated API documentation is published at https://apple.github.io/container/documentation/. ## Frequently Asked Questions ### Where is the official apple/container documentation hosted? All official documentation is stored in the GitHub repository itself under the `main` branch. The primary sources include the root [`README.md`](https://github.com/apple/container/blob/main/README.md) and the `docs/` directory, which contains files like [`docs/command-reference.md`](https://github.com/apple/container/blob/main/docs/command-reference.md) and [`docs/technical-overview.md`](https://github.com/apple/container/blob/main/docs/technical-overview.md). ### How do I access the API documentation for the Swift package? The Swift API documentation is generated automatically from source and hosted at https://apple.github.io/container/documentation/. You can find the link to this site in the repository's [`README.md`](https://github.com/apple/container/blob/main/README.md) file. ### What is the best starting point for learning how to use apple/container? New users should begin with [`docs/tutorials/start-here.md`](https://github.com/apple/container/blob/main/docs/tutorials/start-here.md), which provides a step-by-step guide to building, running, and publishing a simple web-server image. This tutorial is referenced in the root README as the recommended entry point. ### Are configuration details and troubleshooting guides available? Yes, additional documentation covering configuration schemas, system settings, and troubleshooting steps is available in the `docs/` directory, specifically in files like [`docs/container-system-config.md`](https://github.com/apple/container/blob/main/docs/container-system-config.md) and [`docs/bug-report-how-to.md`](https://github.com/apple/container/blob/main/docs/bug-report-how-to.md).