library/registry

Quick reference

• Maintained by:
  https://github.com/distribution/distribution-library-image

• Where to get help:
  CNCF community slack, or Stack Overflow

Supported tags and respective Dockerfile links

• https://github.com/distribution/distribution-library-image/blob/6d24cf20fd78b55dd5d991f2f68bec1e86408609/Dockerfile

Quick reference (cont.)

• Where to file issues:
  https://github.com/distribution/distribution-library-image/issues?q=

• Supported architectures: (https://github.com/docker-library/official-images#architectures-other-than-amd64)
  https://hub.docker.com/r/amd64/registry/, https://hub.docker.com/r/arm32v6/registry/, https://hub.docker.com/r/arm32v7/registry/, https://hub.docker.com/r/arm64v8/registry/, https://hub.docker.com/r/ppc64le/registry/, https://hub.docker.com/r/riscv64/registry/, https://hub.docker.com/r/s390x/registry/

• Published image artifact details:
  https://github.com/docker-library/repo-info/blob/master/repos/registry (https://github.com/docker-library/repo-info/commits/master/repos/registry)
  (image metadata, transfer size, etc)

• Image updates:
  https://github.com/docker-library/official-images/issues?q=label%3Alibrary%2Fregistry
  https://github.com/docker-library/official-images/blob/master/library/registry (https://github.com/docker-library/official-images/commits/master/library/registry)

• Source of this description:
  https://github.com/docker-library/docs/tree/master/registry (https://github.com/docker-library/docs/commits/master/registry)

Distribution Registry

!https://raw.githubusercontent.com/docker-library/docs/b09c592af0d6061629e02e4f674d22848f8236e8/registry/logo.png

This image contains an implementation of the OCI Distribution spec. See https://github.com/opencontainers/distribution-spec for more details about what it is. You can find the full source code in https://github.com/distribution/distribution.

Run a local registry: Quick Version

console
$ docker run -d -p 5000:5000 --restart always --name registry registry:3

Now, use it from within Docker:

console
$ docker pull ubuntu
$ docker tag ubuntu localhost:5000/ubuntu
$ docker push localhost:5000/ubuntu

Recommended Reading

The https://distribution.github.io/distribution/ is a good place to learn more about what the registry is, how it works, and how to use it.

Specifically, https://distribution.github.io/distribution/about/deploying/ has pointers for more complex use cases than simply running a registry on localhost.

License

View https://github.com/distribution/distribution/blob/master/LICENSE for the software contained in this image.

As with all Docker images, these likely also contain other software which may be under other licenses (such as Bash, etc from the base distribution, along with any direct or indirect dependencies of the primary software being contained).

Some additional license information which was able to be auto-detected might be found in https://github.com/docker-library/repo-info/tree/master/repos/registry.

As for any pre-built image usage, it is the image user's responsibility to ensure that any use of this image complies with any relevant licenses for all software contained within.