# Distribution

Distribution is the open-source reference implementation of the OCI Distribution Specification, providing a container registry for storing and delivering container images and other OCI artifacts. It is open source and self-hosted, installable on TrueNAS and Docker Hub.

Canonical page: https://ourlocalhost.com/app/3747/distribution

## Description

Distribution is the open-source reference implementation of the OCI Distribution Specification, providing a container registry for storing and delivering container images and other OCI artifacts. Self-hosters use it to control where their images are stored and to own their image distribution pipeline.

## Platform availability

Available on 1 of 10 platforms: TrueNAS.

## Health score

77/100 (Good), based on 4 of 5 factors.
- Maintained: 100 (last commit 5 days ago)
- Popular: 81 (10,690 GitHub stars)
- Easy to install: 25 (1 install platform, install notes)
- Security check: 76 (no serious findings, 4 minor, CI, tests, OpenSSF Scorecard 7.6/10)

## Links

- Official website: https://distribution.github.io/distribution
- TrueNAS: https://apps.truenas.com/catalog/distribution/
- GitHub: https://github.com/distribution/distribution
- Docker Hub: https://hub.docker.com/r/distribution/distribution
- Documentation: https://distribution.github.io/distribution/spec/auth/scope/

## Common questions

### Do Docker/containerd-style clients communicate with Distribution over a standard protocol?

OCI clients communicate with the registry using HTTP and implement against the OCI Distribution Specification.

### Is the Docker client implementation inside Distribution still the preferred client?

The project includes a client currently in use by Docker, but it is deprecated in favor of the containerd implementation and will not support new features.

### Can developers rely on the Distribution Go libraries as stable APIs?

The libraries are provided for interacting with distribution components, but their interfaces are explicitly unstable.

### Can Distribution be used for both a small private registry and a larger registry deployment?

The project is intended as a simple, secure, and scalable base for running a simple private registry or building a large-scale registry solution.

---
Source: Our Local Host (https://ourlocalhost.com/app/3747/distribution), the self-hosted and open-source app directory.
