Registry

Important

The ability to push deprecated Docker image manifest version 2, schema 1 images to Docker Hub is deprecated as of November 4th, 2024.

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/distribution.

The Docker Hub registry implementation is based on Distribution. Docker Hub implements version 1.0.1 OCI distribution specification. 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 manifest
• Docker image manifest version 2, schema 2
• Docker image manifest version 2, schema 1
• Docker image manifest version 1

You can push images with the following formats:

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

Docker Hub also supports OCI artifacts. See OCI artifacts.

Authentication

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

• Token authentication specification
• OAuth 2.0 token authentication
• JWT authentication
• Token scope and access