Registry

Registry, the open source implementation for storing and distributing container images and other content, has been donated to the CNCF. Registry now goes under the name of Distribution, and the documentation has moved to distribution/distributionopen_in_new.

The Docker Hub registry implementation is based on Distribution. Docker Hub implements version 1.0.1 OCI distribution specificationopen_in_new. For reference documentation on the API protocol that Docker Hub implements, refer to the OCI distribution specification.

Supported media types

Docker Hub supports the following image manifest formats for pulling images:

• OCI image manifestopen_in_new
• Docker image manifest version 2, schema 2open_in_new
• Docker image manifest version 2, schema 1
• Docker image manifest version 1

You can push images with the following formats:

• OCI image manifestopen_in_new
• Docker image manifest version 2, schema 2open_in_new

Docker Hub also supports OCI artifacts. See OCI artifacts.

Authentication

For documentation related to authentication to the Docker Hub registry, see:

• Token authentication specificationopen_in_new
• OAuth 2.0 token authenticationopen_in_new
• JWT authenticationopen_in_new
• Token scope and accessopen_in_new