Protocols
Saved & recent

OCI Distribution Specification

Also called: OCI registry protocol, container registry API

The Open Container Initiative Distribution Specification defines an HTTP API for moving content between clients and registries. Container images are a common use, but the distribution protocol is not limited to that content type. Manifests describe content, blobs hold bytes, and digests identify content by a cryptographic hash.

When pulling an image, a client can retrieve a manifest and then fetch the referenced configuration and layer blobs. A human-readable tag points to a manifest and can change, while a digest identifies particular content. Checking a digest detects a content mismatch; deciding whether a publisher is trustworthy requires additional policy or verification.

Read first
HTTP
Related
HTTP, HTTPS, Protocol conformance
Further reading
Open Container Initiative — Distribution Specification
app:v1 manifest config + layer digests sha256:8c… config sha256:14… layer 1 sha256:aa… layer 2 fetch manifest then fetch missing blobs client registry
An image manifest points to configuration and layer blobs. Tags name manifests; digests identify their content.

View in the full Protocols collection