docker-library/official-images

★ 6,955ShellAudience · ops devopsComplexity · 3/5Setup · hard

Mindmap

mindmap
  root((Official Images))
    What it does
      Curated image registry
      Build definitions
      Quality standards
    Tech Stack
      Shell scripts
      Bashbrew builder
      Docker Hub
    Use Cases
      Propose new image
      Apply best practices
      Maintain versions
    Standards
      Multi-arch builds
      Security rebuilds
      FOSS only

mindmap root((Official Images)) What it does Curated image registry Build definitions Quality standards Tech Stack Shell scripts Bashbrew builder Docker Hub Use Cases Propose new image Apply best practices Maintain versions Standards Multi-arch builds Security rebuilds FOSS only

Click or tap to explore — scroll the page freely

Things people build with this

USE CASE 1

Propose a new official Docker image by submitting a pull request with a library definition file and Dockerfile.

USE CASE 2

Understand Docker's official image quality standards to apply the same best practices in your own private base images.

USE CASE 3

Maintain an existing official image by updating version tags and responding to upstream security advisories promptly.

USE CASE 4

Study how Bashbrew automates building and tagging thousands of images across multiple hardware architectures.

Tech stack

ShellDockerBashBashbrew

Getting it running

Difficulty · hard Time to first run · 1day+

Contributing a new official image requires passing a detailed maintainer checklist and committing to ongoing security maintenance and timely version updates.

In plain English

Docker Official Images is the repository that defines the set of curated, pre-built container images you see when you search Docker Hub without a publisher prefix, things like "ubuntu", "postgres", "python", and "nginx". This repository is the source of truth for which image versions exist, where the Dockerfiles live, and how they should be built. The images in this program follow specific quality standards. They focus on free and open-source software, they are rebuilt regularly when upstream projects release security fixes, they support multiple hardware architectures so the same image name works on regular x86 computers and ARM-based devices, and the Dockerfiles that define them are written to serve as examples of best practices. Anyone can propose a new official image by submitting a pull request to this repository with a definition file. That file specifies the GitHub repository where the Dockerfile lives, which tags to build, and other metadata. Maintainers review the submission against a detailed checklist covering security, consistency, cacheability, and whether the image follows the upstream project's own recommendations for packaging their software. Maintaining an official image is an ongoing commitment. Version bumps and security fixes need to be addressed promptly, and if the upstream project itself wants to take over maintainership, the README describes a process for handing that over cleanly. A tool called Bashbrew handles the automated building and pushing of all official images. The repository also includes an extensive FAQ and review guidelines that explain how the whole program works for anyone who wants to contribute. The full README is longer than what was shown.

Copy-paste prompts

Prompt 1

Walk me through submitting a pull request to docker-library/official-images to add a new official Docker image for my open-source project.

Prompt 2

What Dockerfile best practices are used in Docker official images that I should apply to my own private base images?

Prompt 3

Help me write a library definition file for docker-library/official-images that specifies tags, architectures, and the Dockerfile location for a new image.

Prompt 4

How does the Bashbrew tool work and how can I run it locally to test building an official Docker image before submitting my PR?

Prompt 5

What does the Docker official images maintainer checklist require and how long does the review process typically take?

Open on GitHub → Explain another repo

← docker-library on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.