# Black Docker image Official _Black_ Docker images are available on [Docker Hub](https://hub.docker.com/r/pyfound/black). _Black_ images with the following tags are available: - release numbers, e.g. `21.5b2`, `21.6b0`, `21.7b0` etc.\ ℹ Recommended for users who want to use a particular version of _Black_. - `latest_release` - tag created when a new version of _Black_ is released.\ ℹ Recommended for users who want to use released versions of _Black_. It maps to [the latest release](https://github.com/psf/black/releases/latest) of _Black_. - `latest_prerelease` - tag created when a new alpha (prerelease) version of _Black_ is released.\ ℹ Recommended for users who want to preview or test alpha versions of _Black_. Note that the most recent release may be newer than any prerelease, because no prereleases are created before most releases. - `latest` - tag used for the newest image of _Black_.\ ℹ Recommended for users who always want to use the latest version of _Black_, even before it is released. There is one more tag used for _Black_ Docker images - `latest_non_release`. It is created for all unreleased [commits on the `main` branch](https://github.com/psf/black/commits/main). This tag is not meant to be used by external users. From version 23.11.0 the Docker image installs a compiled black into the image. ## Usage A permanent container doesn't have to be created to use _Black_ as a Docker image. It's enough to run _Black_ commands for the chosen image denoted as `:tag`. In the below examples, the `latest_release` tag is used. If `:tag` is omitted, the `latest` tag will be used. More about _Black_ usage can be found in [Usage and Configuration: The basics](./the_basics.md). ### Check Black version ```console $ docker run --rm pyfound/black:latest_release black --version ``` ### Check code ```console $ docker run --rm --volume $(pwd):/src --workdir /src pyfound/black:latest_release black --check . ``` _Remark_: besides [regular _Black_ exit codes](./the_basics.md) returned by `--check` option, [Docker exit codes](https://docs.docker.com/engine/reference/run/#exit-status) should also be considered.