# docker-library/official-images

Primary source of truth for the Docker "Official Images" program

Repository: https://github.com/docker-library/official-images
Canonical: https://ross.abutalabs.com/products/official-images
Homepage: https://hub.docker.com/u/library
Language: Shell
License: Apache-2.0
License Family: permissive
Last push: 2026-08-26T18:32:22+00:00

## Health v2 (maintenance only)
Score: 77/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 35, longevity 100
- inputs: {"age_days": 4703, "days_push": 7, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 6995, forks 2528 (observed 2026-08-28T04:09:52.496196+00:00)

## What it is
The primary source of truth for Docker's Official Images program, containing library definition files, review guidelines, and the Bashbrew tooling used to build and publish curated Docker Hub images. It governs a set of vetted, multi-architecture container images rebuilt for security updates.

## Use cases
- find trusted base images for dockerfiles
- propose a new official docker image for my project
- understand dockerfile best practices from curated examples
- check which architectures an official image supports
- build and verify official image tags with bashbrew
- get security updates for standard container images

## When to choose
- you need trustworthy, actively maintained base images on Docker Hub
- you want to contribute or maintain an Official Image
- you need reference Dockerfiles exemplifying best practices

## When to avoid
- you need application-specific or niche images outside the curated library
- you want a general container build tool rather than image definitions
- you need private or custom image publishing workflows

## Facets
- artifact type: dataset
- maturity: active
- function: container-runtime, developer-tools, build-tool, security
- domain: developer-tools, self-hosted
- platform: cross-platform, self-hosted
- tags: docker-official-images, docker-hub, container-images, bashbrew, dockerfile-best-practices, multi-architecture, devops, containers, docker, linux

## Member repositories
- docker-library/official-images (main) score 77

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:09:52.496196+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:41:06.397391+00:00, confidence not recorded.
  - readme: https://github.com/docker-library/official-images (fetched 2026-08-28T04:09:52.496196+00:00, sha 543ee6ce17a2)
  - homepage: https://hub.docker.com/u/library (fetched 2026-08-29T08:36:41.442941+00:00, sha bf6b590997aa)
  - site_page: https://docs.docker.com/docker-hub (fetched 2026-08-29T08:36:41.445841+00:00, sha caaa18892709)
  - site_page: https://www.docker.com/docs (fetched 2026-08-29T08:36:41.447763+00:00, sha aeada2272712)
  - site_page: https://www.docker.com/company (fetched 2026-08-29T08:36:41.449651+00:00, sha 05ab59b2bc29)
- Data as of 2026-08-30T08:39:29.467469+00:00.