# What Container Image Format Does Apple’s Container Tool Support?

> Apple's container tool supports the OCI image specification ensuring compatibility with any Open Container Initiative compliant registry or runtime.

- Repository: [Apple/container](https://github.com/apple/container)
- Tags: faq
- Published: 2026-07-03

---

**Apple’s `container` command-line tool exclusively supports the OCI image specification, making it compatible with any container registry or runtime that follows the Open Container Initiative standards.**

Apple’s open-source `container` repository provides a lightweight command-line interface for building and managing containers. Understanding which **container image format** the tool supports is critical for integrating it into existing DevOps pipelines. According to the project documentation, the tool works exclusively with the **OCI image format**, ensuring broad compatibility across the container ecosystem.

## OCI Image Format Compatibility

The `apple/container` tool implements the Open Container Initiative (OCI) image specification as its sole supported format. According to [`README.md`](https://github.com/apple/container/blob/main/README.md) (lines 6-9), the tool both consumes and produces OCI-compatible images, allowing it to interoperate with standard container registries and runtimes.

The technical architecture is detailed in [`docs/technical-overview.md`](https://github.com/apple/container/blob/main/docs/technical-overview.md) (lines 20-33), which explains that this OCI compatibility ensures seamless integration with other OCI-based tools. This means images built with Apple Container follow the industry-standard manifest, layer, and configuration formats defined by the OCI.

## Working with OCI Images in Apple Container

As documented in [`docs/command-reference.md`](https://github.com/apple/container/blob/main/docs/command-reference.md) (lines 14-24) and demonstrated in [`docs/tutorials/start-here.md`](https://github.com/apple/container/blob/main/docs/tutorials/start-here.md) (lines 118-154), the tool provides a complete workflow for managing OCI images from build to distribution.

### Building OCI Images

To build an OCI image from a Dockerfile, use the `build` command:

```bash
container build -t my-app:latest .

```

### Listing and Inspecting Images

View locally stored OCI images with the `image list` command:

```bash
container image list

```

### Distributing OCI Images

Pull OCI images from remote registries using standard OCI registry URLs:

```bash
container image pull docker.io/library/alpine:latest

```

Push local OCI images to any OCI-compliant registry:

```bash
container image push myregistry.example.com/fido/web-test:latest

```

### Running OCI Containers

Execute containers from OCI images using the `run` command:

```bash
container run --name my-app my-app:latest

```

## Summary

- Apple Container exclusively supports the **OCI image specification** for both input and output, as stated in [`README.md`](https://github.com/apple/container/blob/main/README.md).
- The tool provides full lifecycle management of OCI images, including build, pull, push, list, and run operations documented in [`docs/command-reference.md`](https://github.com/apple/container/blob/main/docs/command-reference.md).
- OCI compatibility ensures interoperability with major container registries and existing Docker images.
- All image operations follow the standard OCI manifest and layer formats defined in [`docs/technical-overview.md`](https://github.com/apple/container/blob/main/docs/technical-overview.md).

## Frequently Asked Questions

### Does Apple Container support Docker images?

Yes. Docker images conform to the OCI image specification, making them fully compatible with Apple Container. You can pull, run, and build images using Dockerfiles, and the resulting OCI images work with Docker-compatible registries.

### Can I push images to any container registry?

Yes. Apple Container works with any registry that supports the OCI image specification, including Docker Hub, GitHub Container Registry, and private OCI-compliant registries. The `container image push` command implements the standard OCI distribution protocol.

### What does OCI-compatible mean in the context of Apple Container?

OCI-compatible means the tool implements the Open Container Initiative image specification for manifests, layers, and configurations. According to [`docs/technical-overview.md`](https://github.com/apple/container/blob/main/docs/technical-overview.md), this ensures images created by the tool are portable across any OCI-compliant runtime or registry.

### Does Apple Container support non-OCI image formats?

No. The tool exclusively supports OCI-compatible images as documented in [`README.md`](https://github.com/apple/container/blob/main/README.md) (lines 6-9). It does not support legacy or proprietary container image formats that deviate from the OCI specification.