# Supported tags and respective `Dockerfile` links - [`8.8`, `8`, `jessie`, `latest` (*jessie/Dockerfile*)](https://github.com/tianon/docker-brew-debian/blob/f847fca3796b37498b1ad0e8165da2aee41d0faf/jessie/Dockerfile) - [`jessie-slim` (*jessie/slim/Dockerfile*)](https://github.com/tianon/docker-brew-debian/blob/f847fca3796b37498b1ad0e8165da2aee41d0faf/jessie/slim/Dockerfile) - [`jessie-backports` (*jessie/backports/Dockerfile*)](https://github.com/tianon/docker-brew-debian/blob/f847fca3796b37498b1ad0e8165da2aee41d0faf/jessie/backports/Dockerfile) - [`oldstable` (*oldstable/Dockerfile*)](https://github.com/tianon/docker-brew-debian/blob/2a84577b9320d123f08af68001dd7013ae7f67fd/oldstable/Dockerfile) - [`oldstable-slim` (*oldstable/slim/Dockerfile*)](https://github.com/tianon/docker-brew-debian/blob/2a84577b9320d123f08af68001dd7013ae7f67fd/oldstable/slim/Dockerfile) - [`oldstable-backports` (*oldstable/backports/Dockerfile*)](https://github.com/tianon/docker-brew-debian/blob/2a84577b9320d123f08af68001dd7013ae7f67fd/oldstable/backports/Dockerfile) - [`sid` (*sid/Dockerfile*)](https://github.com/tianon/docker-brew-debian/blob/6a620dbc1df446fcabdcd4c9c42a650a26377eb5/sid/Dockerfile) - [`sid-slim` (*sid/slim/Dockerfile*)](https://github.com/tianon/docker-brew-debian/blob/6a620dbc1df446fcabdcd4c9c42a650a26377eb5/sid/slim/Dockerfile) - [`stable` (*stable/Dockerfile*)](https://github.com/tianon/docker-brew-debian/blob/f847fca3796b37498b1ad0e8165da2aee41d0faf/stable/Dockerfile) - [`stable-slim` (*stable/slim/Dockerfile*)](https://github.com/tianon/docker-brew-debian/blob/f847fca3796b37498b1ad0e8165da2aee41d0faf/stable/slim/Dockerfile) - [`stable-backports` (*stable/backports/Dockerfile*)](https://github.com/tianon/docker-brew-debian/blob/f847fca3796b37498b1ad0e8165da2aee41d0faf/stable/backports/Dockerfile) - [`9.0`, `9`, `stretch` (*stretch/Dockerfile*)](https://github.com/tianon/docker-brew-debian/blob/6a620dbc1df446fcabdcd4c9c42a650a26377eb5/stretch/Dockerfile) - [`stretch-slim` (*stretch/slim/Dockerfile*)](https://github.com/tianon/docker-brew-debian/blob/6a620dbc1df446fcabdcd4c9c42a650a26377eb5/stretch/slim/Dockerfile) - [`testing` (*testing/Dockerfile*)](https://github.com/tianon/docker-brew-debian/blob/6a620dbc1df446fcabdcd4c9c42a650a26377eb5/testing/Dockerfile) - [`testing-slim` (*testing/slim/Dockerfile*)](https://github.com/tianon/docker-brew-debian/blob/6a620dbc1df446fcabdcd4c9c42a650a26377eb5/testing/slim/Dockerfile) - [`unstable` (*unstable/Dockerfile*)](https://github.com/tianon/docker-brew-debian/blob/6a620dbc1df446fcabdcd4c9c42a650a26377eb5/unstable/Dockerfile) - [`unstable-slim` (*unstable/slim/Dockerfile*)](https://github.com/tianon/docker-brew-debian/blob/6a620dbc1df446fcabdcd4c9c42a650a26377eb5/unstable/slim/Dockerfile) - [`7.11`, `7`, `wheezy` (*wheezy/Dockerfile*)](https://github.com/tianon/docker-brew-debian/blob/2a84577b9320d123f08af68001dd7013ae7f67fd/wheezy/Dockerfile) - [`wheezy-slim` (*wheezy/slim/Dockerfile*)](https://github.com/tianon/docker-brew-debian/blob/2a84577b9320d123f08af68001dd7013ae7f67fd/wheezy/slim/Dockerfile) - [`wheezy-backports` (*wheezy/backports/Dockerfile*)](https://github.com/tianon/docker-brew-debian/blob/2a84577b9320d123f08af68001dd7013ae7f67fd/wheezy/backports/Dockerfile) - [`rc-buggy` (*debian/rc-buggy/Dockerfile*)](https://github.com/tianon/dockerfiles/blob/22a998f815d55217afa0075411b810b8889ceac1/debian/rc-buggy/Dockerfile) - [`experimental` (*debian/experimental/Dockerfile*)](https://github.com/tianon/dockerfiles/blob/22a998f815d55217afa0075411b810b8889ceac1/debian/experimental/Dockerfile) # Quick reference - **Where to get help**: [the Docker Community Forums](https://forums.docker.com/), [the Docker Community Slack](https://blog.docker.com/2016/11/introducing-docker-community-directory-docker-community-slack/), or [Stack Overflow](https://stackoverflow.com/search?tab=newest&q=docker) - **Where to file issues**: [https://github.com/tianon/docker-brew-debian/issues](https://github.com/tianon/docker-brew-debian/issues) - **Maintained by**: Debian Developers [tianon](https://qa.debian.org/developer.php?login=tianon) and [paultag](https://qa.debian.org/developer.php?login=paultag) - **Published image artifact details**: [repo-info repo's `repos/debian/` directory](https://github.com/docker-library/repo-info/blob/master/repos/debian) ([history](https://github.com/docker-library/repo-info/commits/master/repos/debian)) (image metadata, transfer size, etc) - **Image updates**: [official-images PRs with label `library/debian`](https://github.com/docker-library/official-images/pulls?q=label%3Alibrary%2Fdebian) [official-images repo's `library/debian` file](https://github.com/docker-library/official-images/blob/master/library/debian) ([history](https://github.com/docker-library/official-images/commits/master/library/debian)) - **Source of this description**: [docs repo's `debian/` directory](https://github.com/docker-library/docs/tree/master/debian) ([history](https://github.com/docker-library/docs/commits/master/debian)) - **Supported Docker versions**: [the latest release](https://github.com/docker/docker/releases/latest) (down to 1.6 on a best-effort basis) # What is Debian? Debian is an operating system which is composed primarily of free and open-source software, most of which is under the GNU General Public License, and developed by a group of individuals known as the Debian project. Debian is one of the most popular Linux distributions for personal computers and network servers, and has been used as a base for several other Linux distributions. > [wikipedia.org/wiki/Debian](https://en.wikipedia.org/wiki/Debian)  # About this image The `debian:latest` tag will always point the latest stable release (which is, at the time of this writing, `debian:jessie`). Stable releases are also tagged with their version (ie, `debian:8` is an alias for `debian:jessie`, `debian:7` is an alias for `debian:wheezy`, etc). The rolling tags (`debian:stable`, `debian:testing`, etc) use the rolling suite names in their `/etc/apt/sources.list` file (ie, `deb http://deb.debian.org/debian testing main`). The mirror of choice for these images is [the deb.debian.org CDN pointer/redirector](https://deb.debian.org) so that it's as reliable as possible for the largest subset of users (and is also the default mirror for `debootstrap` as of [2016-10-20](https://anonscm.debian.org/cgit/d-i/debootstrap.git/commit/?id=9e8bc60ad1ccf3a25ce7890526b70059f3e770de)). See the [deb.debian.org homepage](https://deb.debian.org) for more information. If you find yourself needing a Debian release which is EOL (and thus only available from [archive.debian.org](http://archive.debian.org)), you should check out [the `debian/eol` image](https://hub.docker.com/r/debian/eol/), which includes tags for Debian releases as far back as Potato (Debian 2.2), the first release to fully utilize APT. ## Locales Given that it is a faithful "minbase" install of Debian, this image only includes the `C`, `C.UTF-8`, and `POSIX` locales by default. For most uses requiring a UTF-8 locale, `C.UTF-8` is likely sufficient (`-e LANG=C.UTF-8` or `ENV LANG C.UTF-8`). For uses where that is not sufficient, other locales can be installed/generated via the `locales` package. [PostgreSQL has a good example of doing so](https://github.com/docker-library/postgres/blob/69bc540ecfffecce72d49fa7e4a46680350037f9/9.6/Dockerfile#L21-L24), copied below: ```dockerfile RUN apt-get update && apt-get install -y locales && rm -rf /var/lib/apt/lists/* \ && localedef -i en_US -c -f UTF-8 -A /usr/share/locale/locale.alias en_US.UTF-8 ENV LANG en_US.utf8 ``` ## `-slim` variants These tags are an experiment in providing a slimmer base (removing some extra files that are normally not necessary within containers, such as man pages and documentation), and are definitely subject to change. See [the discussion in tianon/docker-brew-debian#48](https://github.com/tianon/docker-brew-debian/issues/48) for some notes/details regarding the specifics of the implementation. ## How It's Made If you are curious about what goes into creating this image, please see [`contrib/mkimage.sh` in `github.com/docker/docker`](https://github.com/docker/docker/blob/master/contrib/mkimage.sh) (and [`contrib/mkimage/debootstrap` in the same repo](https://github.com/docker/docker/blob/master/contrib/mkimage/debootstrap)). Those are invoked by [`update.sh` in the image repository](https://github.com/tianon/docker-brew-debian/blob/master/update.sh), which provides some additional functionality such as generating `-backports` contents and repacking the generated tarballs for the `-slim` variants. Additional interesting information is provided in files on the [relevant `dist` branch](https://github.com/tianon/docker-brew-debian/branches) of the image repository, namely the exact command used to build (`SUITE/build-command.txt`), a full log of the build itself (`SUITE/build.log`), and the "build manifest" (`SUITE/build.manifest`, which lists the version numbers of all the packages included in the rootfs tarball).