official-images

# Docker Official Images

## Table of Contents

<!-- AUTOGENERATED TOC -->

1.	[Docker Official Images](#docker-official-images)
	1.	[Table of Contents](#table-of-contents)
	2.	[What are "Official Images"?](#what-are-official-images)
	3.	[Architectures other than amd64?](#architectures-other-than-amd64)
	4.	[More FAQs?](#more-faqs)
	5.	[Contributing to the standard library](#contributing-to-the-standard-library)
		1.	[Review Guidelines](#review-guidelines)
			1.	[Maintainership](#maintainership)
			2.	[Repeatability](#repeatability)
			3.	[Consistency](#consistency)
			4.	[Clarity](#clarity)
			5.	[init](#init)
			6.	[Cacheability](#cacheability)
			7.	[Security](#security)
				1.	[Image Build](#image-build)
				2.	[Runtime Configuration](#runtime-configuration)
				3.	[Security Releases](#security-releases)
			8.	[Multiple Architectures](#multiple-architectures)
		2.	[Commitment](#commitment)
	6.	[Library definition files](#library-definition-files)
		1.	[Filenames](#filenames)
		2.	[Tags and aliases](#tags-and-aliases)
		3.	[Instruction format](#instruction-format)
		4.	[Creating a new repository](#creating-a-new-repository)
		5.	[Adding a new tag in an existing repository (that you're the maintainer of)](#adding-a-new-tag-in-an-existing-repository-that-youre-the-maintainer-of)
		6.	[Change to a tag in an existing repository (that you're the maintainer of)](#change-to-a-tag-in-an-existing-repository-that-youre-the-maintainer-of)
	7.	[Bashbrew](#bashbrew)

<!-- AUTOGENERATED TOC -->

## What are "Official Images"?

The Docker Official Images are curated images [hosted on Docker Hub](https://hub.docker.com/u/library). The main tenets are:

- Focus on [Free](https://www.debian.org/social_contract#guidelines) and [Open-Source](https://opensource.org/) Software

- Support [multiple architectures](#architectures-other-than-amd64)

- Exemplify [`Dockerfile` best practices](https://docs.docker.com/develop/develop-images/dockerfile_best-practices/)

- [Actively rebuild](#library-definition-files) for updates and security fixes

- Adhere to upstream recommendations

- Add minimal quality-of-life behavior for the container environment where fit

See [Docker's documentation](https://docs.docker.com/docker-hub/official_repos/) for a good high-level overview of the program.

In essence we strive to heed upstream's recommendations on how they intend for their software to be consumed. Many images are maintained in collaboration with the relevant upstream project if not maintained directly by them. Additionally we aim to exemplify the best practices for Dockerfiles to serve as a reference when making or deriving your own images from them.

(If you are a representative of an upstream for which there exists an image and you would like to get involved, please see the [Maintainership](#maintainership) section below!)

## Architectures other than amd64?

Some images have been ported for other architectures, and many of these are officially supported (to various degr