Distribution

Distribution is the open-source reference implementation of the OCI Distribution Specification, providing a container registry for storing and delivering…

  • Development
  • Productivity
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

  • Unraid (not listed)
  • TrueNAS
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

77/100 Good

Maintained
100last commit 5 days ago
Popular
8110,690 GitHub stars
Easy to install
251 install platform, install notes
Light to run
No data
Security check
76no serious findings, 4 minor, CI, tests, OpenSSF Scorecard 7.6/10

Based on 4 of 5 factors.

Availability: platform listings confirmed today, links checked 12 days ago

GitHub stars
10,690
Open issues
547
Last commit
2026-11-16
Latest release
v3.1.2
License
Apache-2.0
Activity
steady

Checked 5 days ago - source: GitHub (distribution/distribution)

Resources & Compatibility

Requirements not published yet.

First-install notes

  • Deploying via Docker Deploy using the official distribution/distribution Docker image. Configure a storage backend (local filesystem or S3-compatible object storage) via environment variables when running the container. source

Fetched 4 days ago - each note links to its source

Alternatives

No alternatives collected yet.

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.

Answers sourced from github.com

Community

Collected 48 days ago - public community threads