Skip to content

engine: freshness #23125

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 8 commits into
base: main
Choose a base branch
from
Open

engine: freshness #23125

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
8 commits
Select commit Hold shift + click to select a range
2585291
engine
ArthurFlag Jul 21, 2025
a81a152
install
ArthurFlag Jul 21, 2025
fd57681
centos
ArthurFlag Jul 21, 2025
d24440e
debian
ArthurFlag Jul 21, 2025
d45768e
fedora
ArthurFlag Jul 21, 2025
02d9404
rhel
ArthurFlag Jul 21, 2025
00b0bf4
sles
ArthurFlag Jul 21, 2025
82b8d28
tweaks
ArthurFlag Jul 23, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions content/manuals/engine/_index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
---
title: Docker Engine
weight: 10
description: Find a comprehensive overview of Docker Engine, including how to install, storage details, networking, and more
keywords: Engine
description: Comprehensive guide to Docker Engine - installation, configuration, storage, networking, and container management for developers
keywords: Docker Engine, containerization, Docker daemon, Docker CLI, container management, open source, installation, networking, storage
params:
sidebar:
group: Open source
Expand Down Expand Up @@ -76,6 +76,6 @@ For more details, see

The Docker Engine is licensed under the Apache License, Version 2.0. See
[LICENSE](https://github.com/moby/moby/blob/master/LICENSE) for the full license
text.
text.

However, for commercial use of Docker Engine obtained via Docker Desktop within larger enterprises (exceeding 250 employees OR with annual revenue surpassing $10 million USD), a [paid subscription](https://www.docker.com/pricing/) is required.
45 changes: 20 additions & 25 deletions content/manuals/engine/install/_index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -33,10 +33,10 @@
- /install/linux/docker-ee/oracle/
---

This section describes how to install Docker Engine on Linux, also known as
Docker CE. Docker Engine is also available for Windows, macOS, and Linux,
through Docker Desktop. For instructions on how to install Docker Desktop,
see: [Overview of Docker Desktop](/manuals/desktop/_index.md).
This section describes how to install Docker Engine on Linux, also known as Docker CE. Docker Engine is also available for Windows, macOS, and Linux through Docker Desktop.

Check warning on line 36 in content/manuals/engine/install/_index.md

View workflow job for this annotation

GitHub Actions / validate (vale) 

[vale] reported by reviewdog 🐶
[Docker.Acronyms] 'CE' has no definition.

Raw Output:
{"message": "[Docker.Acronyms] 'CE' has no definition.", "location": {"path": "content/manuals/engine/install/_index.md", "range": {"start": {"line": 36, "column": 84}}}, "severity": "WARNING"}

Check failure on line 36 in content/manuals/engine/install/_index.md

View workflow job for this annotation

GitHub Actions / validate (vale) 

[vale] reported by reviewdog 🐶
[Docker.Forbidden] Use 'Docker Engine' instead of 'Docker CE'.

Raw Output:
{"message": "[Docker.Forbidden] Use 'Docker Engine' instead of 'Docker CE'.", "location": {"path": "content/manuals/engine/install/_index.md", "range": {"start": {"line": 36, "column": 77}}}, "severity": "ERROR"}

> [!TIP]
> To install Docker Desktop, see [Overview of Docker Desktop](/manuals/desktop/_index.md).

## Supported platforms

Expand All @@ -54,33 +54,28 @@
### Other Linux distributions

> [!NOTE]
>
> While the following instructions may work, Docker doesn't test or verify
> installation on distribution derivatives.

- If you use Debian derivatives such as "BunsenLabs Linux", "Kali Linux" or
"LMDE" (Debian-based Mint) should follow the installation instructions for
[Debian](debian.md), substitute the version of your distribution for the
corresponding Debian release. Refer to the documentation of your distribution to find
which Debian release corresponds with your derivative version.
- Likewise, if you use Ubuntu derivatives such as "Kubuntu", "Lubuntu" or "Xubuntu"
you should follow the installation instructions for [Ubuntu](ubuntu.md),
substituting the version of your distribution for the corresponding Ubuntu release.
Refer to the documentation of your distribution to find which Ubuntu release
corresponds with your derivative version.
> While the following instructions may work, Docker doesn't test or verify installation on distribution derivatives.

- For Debian derivatives (for example, BunsenLabs Linux, Kali Linux, LMDE):

Check warning on line 59 in content/manuals/engine/install/_index.md

View workflow job for this annotation

GitHub Actions / validate (vale) 

[vale] reported by reviewdog 🐶
[Docker.Acronyms] 'LMDE' has no definition.

Raw Output:
{"message": "[Docker.Acronyms] 'LMDE' has no definition.", "location": {"path": "content/manuals/engine/install/_index.md", "range": {"start": {"line": 59, "column": 70}}}, "severity": "WARNING"}
- Follow the [Debian installation instructions](debian.md).
- Substitute your distribution version for the corresponding Debian release.
- Check your distribution's documentation for the matching Debian release.
- For Ubuntu derivatives (for example, Kubuntu, Lubuntu, Xubuntu):

Check failure on line 63 in content/manuals/engine/install/_index.md

View workflow job for this annotation

GitHub Actions / validate (vale) 

[vale] reported by reviewdog 🐶
[Vale.Spelling] Did you really mean 'Lubuntu'?

Raw Output:
{"message": "[Vale.Spelling] Did you really mean 'Lubuntu'?", "location": {"path": "content/manuals/engine/install/_index.md", "range": {"start": {"line": 63, "column": 49}}}, "severity": "ERROR"}

Check failure on line 63 in content/manuals/engine/install/_index.md

View workflow job for this annotation

GitHub Actions / validate (vale) 

[vale] reported by reviewdog 🐶
[Vale.Spelling] Did you really mean 'Kubuntu'?

Raw Output:
{"message": "[Vale.Spelling] Did you really mean 'Kubuntu'?", "location": {"path": "content/manuals/engine/install/_index.md", "range": {"start": {"line": 63, "column": 40}}}, "severity": "ERROR"}
- Follow the [Ubuntu installation instructions](ubuntu.md).
- Substitute your distribution version for the corresponding Ubuntu release.
- Check your distribution's documentation for the matching Ubuntu release.
- Some Linux distributions provide a package of Docker Engine through their
package repositories. These packages are built and maintained by the Linux
distribution's package maintainers and may have differences in configuration
or are built from modified source code. Docker isn't involved in releasing these
packages and you should report any bugs or issues involving these packages to
your Linux distribution's issue tracker.

Docker provides [binaries](binaries.md) for manual installation of Docker Engine.
These binaries are statically linked and you can use them on any Linux distribution.
Docker provides [binaries](binaries.md) for manual installation. These binaries are statically linked and work on any Linux distribution.

## Release channels

Docker Engine has two types of update channels, **stable** and **test**:
Docker Engine has two update channels: **stable** and **test**.

* The **stable** channel gives you the latest versions released for general availability.
* The **test** channel gives you pre-release versions that are ready for testing before
Expand All @@ -101,7 +96,7 @@

### Upgrade path

Patch releases are always backward compatible with its major and minor version.
Patch releases are always backward compatible with their major and minor version.

### Licensing

Expand All @@ -111,11 +106,11 @@

## Reporting security issues

If you discover a security issue, we request that you bring it to our attention immediately.
If you discover a security issue, report it immediately.

DO NOT file a public issue. Instead, submit your report privately to [email protected].
Do not file a public issue. Instead, send your report privately to [email protected].

Check failure on line 111 in content/manuals/engine/install/_index.md

View workflow job for this annotation

GitHub Actions / validate (vale) 

[vale] reported by reviewdog 🐶
[Docker.Capitalization] Please capitalize Docker.

Raw Output:
{"message": "[Docker.Capitalization] Please capitalize Docker.", "location": {"path": "content/manuals/engine/install/_index.md", "range": {"start": {"line": 111, "column": 76}}}, "severity": "ERROR"}

Security reports are greatly appreciated, and Docker will publicly thank you for it.
Docker appreciates security reports and will publicly thank you for your contribution.

## Get started

Expand Down
65 changes: 25 additions & 40 deletions content/manuals/engine/install/centos.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@
---

To get started with Docker Engine on CentOS, make sure you
[meet the prerequisites](#prerequisites), and then follow the
[meet the prerequisites](#prerequisites), and follow the
[installation steps](#installation-methods).

## Prerequisites
Expand All @@ -31,16 +31,15 @@

- CentOS 9 (stream)

The `centos-extras` repository must be enabled. This repository is enabled by
default. If you have disabled it, you need to re-enable it.
> [!NOTE]
> The `centos-extras` repository must be enabled. This repository is enabled by default.
> If you have disabled it, re-enable it before proceeding.

### Uninstall old versions

Before you can install Docker Engine, you need to uninstall any conflicting packages.

Your Linux distribution may provide unofficial Docker packages, which may conflict
with the official packages provided by Docker. You must uninstall these packages
before you install the official version of Docker Engine.
Uninstall unofficial or conflicting Docker packages provided
by your Linux distribution before installing Docker Engine.
Remove the following packages if present:

```console
$ sudo dnf remove docker \
Expand All @@ -55,36 +54,25 @@

`dnf` might report that you have none of these packages installed.

Images, containers, volumes, and networks stored in `/var/lib/docker/` aren't
automatically removed when you uninstall Docker.
> [!NOTE]
> Images, containers, volumes, and networks stored in `/var/lib/docker/` are
> not automatically removed when you uninstall Docker.

## Installation methods

You can install Docker Engine in different ways, depending on your needs:

- You can
[set up Docker's repositories](#install-using-the-repository) and install
from them, for ease of installation and upgrade tasks. This is the
recommended approach.

- You can download the RPM package,
[install it manually](#install-from-a-package), and manage
upgrades completely manually. This is useful in situations such as installing
Docker on air-gapped systems with no access to the internet.
You can install Docker Engine in different ways:

- In testing and development environments, you can use automated
[convenience scripts](#install-using-the-convenience-script) to install Docker.
- Recommended: [Set up Docker's repositories](#install-using-the-repository) and install from them for easy installation and upgrades.
- Manual: [Download the RPM package](#install-from-a-package) and install it manually. Useful for air-gapped systems.
- Development/testing: Use [convenience scripts](#install-using-the-convenience-script) for quick setup.

### Install using the rpm repository {#install-using-the-repository}

Before you install Docker Engine for the first time on a new host machine, you
need to set up the Docker repository. Afterward, you can install and update
Docker from the repository.
Before installing Docker Engine for the first time on a new host, set up the Docker repository. Afterward, you can install and update Docker from the repository.

#### Set up the repository

Install the `dnf-plugins-core` package (which provides the commands to manage
your DNF repositories) and set up the repository.
Install the `dnf-plugins-core` package (provides commands to manage DNF repositories) and set up the repository.

Check warning on line 75 in content/manuals/engine/install/centos.md

View workflow job for this annotation

GitHub Actions / validate (vale) 

[vale] reported by reviewdog 🐶
[Docker.Acronyms] 'DNF' has no definition.

Raw Output:
{"message": "[Docker.Acronyms] 'DNF' has no definition.", "location": {"path": "content/manuals/engine/install/centos.md", "range": {"start": {"line": 75, "column": 69}}}, "severity": "WARNING"}

```console
$ sudo dnf -y install dnf-plugins-core
Expand Down Expand Up @@ -144,7 +132,7 @@
{{< /tab >}}
{{< /tabs >}}

2. Start Docker Engine.
1. Start Docker Engine:

```console
$ sudo systemctl enable --now docker
Expand All @@ -154,16 +142,15 @@
boot your system. If you don't want Docker to start automatically, use `sudo
systemctl start docker` instead.

3. Verify that the installation is successful by running the `hello-world` image:
1. Verify the installation by running the `hello-world` image:

```console
$ sudo docker run hello-world
```

This command downloads a test image and runs it in a container. When the
container runs, it prints a confirmation message and exits.
This downloads a test image and runs it in a container. When the container runs, it prints a confirmation message and exits.

You have now successfully installed and started Docker Engine.
You have now installed and started Docker Engine.

{{% include "root-errors.md" %}}

Expand All @@ -174,9 +161,7 @@

### Install from a package

If you can't use Docker's `rpm` repository to install Docker Engine, you can
download the `.rpm` file for your release and install it manually. You need to
download a new file each time you want to upgrade Docker Engine.
If you cannot use Docker's `rpm` repository, download the `.rpm` file for your release and install it manually. Download a new file each time you want to upgrade Docker Engine.

<!-- markdownlint-disable-next-line -->
1. Go to [{{% param "download-url-base" %}}/]({{% param "download-url-base" %}}/)
Expand All @@ -190,10 +175,10 @@
$ sudo dnf install /path/to/package.rpm
```

Docker is installed but not started. The `docker` group is created, but no
users are added to the group.
Docker is installed but not started. The `docker` group
is created, but no users are added to the group.

3. Start Docker Engine.
3. Start Docker Engine:

```console
$ sudo systemctl enable --now docker
Expand Down Expand Up @@ -232,7 +217,7 @@
$ sudo dnf remove docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin docker-ce-rootless-extras
```

2. Images, containers, volumes, or custom configuration files on your host
1. Images, containers, volumes, or custom configuration files on your host
aren't automatically removed. To delete all images, containers, and volumes:

```console
Expand Down
59 changes: 24 additions & 35 deletions content/manuals/engine/install/debian.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -27,20 +27,16 @@ To get started with Docker Engine on Debian, make sure you
> Before you install Docker, make sure you consider the following
> security implications and firewall incompatibilities.

- If you use ufw or firewalld to manage firewall settings, be aware that
when you expose container ports using Docker, these ports bypass your
firewall rules. For more information, refer to
[Docker and ufw](/manuals/engine/network/packet-filtering-firewalls.md#docker-and-ufw).
- Docker is only compatible with `iptables-nft` and `iptables-legacy`.
Firewall rules created with `nft` are not supported on a system with Docker installed.
Make sure that any firewall rulesets you use are created with `iptables` or `ip6tables`,
and that you add them to the `DOCKER-USER` chain,
see [Packet filtering and firewalls](/manuals/engine/network/packet-filtering-firewalls.md).
- When exposing container ports with Docker, these ports bypass `ufw` or `firewalld` rules.
See [Docker and ufw](/manuals/engine/network/packet-filtering-firewalls.md#docker-and-ufw) for details.
- Docker supports only `iptables-nft` and `iptables-legacy`.
Rules created with `nft` are not supported on a system with Docker installed.
Use `iptables` or `ip6tables` and add rules to the `DOCKER-USER` chain.
See [Packet filtering and firewalls](/manuals/engine/network/packet-filtering-firewalls.md).

### OS requirements

To install Docker Engine, you need the 64-bit version of one of these Debian
versions:
Docker Engine requires a 64-bit version of one of these Debian releases:

- Debian Trixie 13 (testing)
- Debian Bookworm 12 (stable)
Expand All @@ -51,13 +47,9 @@ and ppc64le (ppc64el) architectures.

### Uninstall old versions

Before you can install Docker Engine, you need to uninstall any conflicting packages.

Your Linux distribution may provide unofficial Docker packages, which may conflict
with the official packages provided by Docker. You must uninstall these packages
before you install the official version of Docker Engine.

The unofficial packages to uninstall are:
Uninstall unofficial or conflicting Docker packages provided
by your Linux distribution before installing Docker Engine.
Remove the following packages if present:

- `docker.io`
- `docker-compose`
Expand All @@ -75,12 +67,11 @@ Run the following command to uninstall all conflicting packages:
$ for pkg in docker.io docker-doc docker-compose podman-docker containerd runc; do sudo apt-get remove $pkg; done
```

`apt-get` might report that you have none of these packages installed.
> [!NOTE]
> `apt-get` might report that you have none of these packages installed.
> Images, containers, volumes, and networks in `/var/lib/docker/` are not removed automatically.

Images, containers, volumes, and networks stored in `/var/lib/docker/` aren't
automatically removed when you uninstall Docker. If you want to start with a
clean installation, and prefer to clean up any existing data, read the
[uninstall Docker Engine](#uninstall-docker-engine) section.
For a clean install, see [uninstall Docker Engine](#uninstall-docker-engine).

## Installation methods

Expand Down Expand Up @@ -135,7 +126,7 @@ Docker from the repository.
> Replace this part with the codename of the corresponding Debian release,
> such as `bookworm`.

2. Install the Docker packages.
1. Install the Docker packages.

{{< tabs >}}
{{< tab name="Latest" >}}
Expand Down Expand Up @@ -171,7 +162,7 @@ Docker from the repository.
{{< /tab >}}
{{< /tabs >}}

3. Verify that the installation is successful by running the `hello-world` image:
1. Verify that the installation is successful by running the `hello-world` image:

```console
$ sudo docker run hello-world
Expand All @@ -192,19 +183,17 @@ choosing the new version you want to install.

### Install from a package

If you can't use Docker's `apt` repository to install Docker Engine, you can
download the `deb` file for your release and install it manually. You need to
download a new file each time you want to upgrade Docker Engine.
If you can't use the `apt` repository, download and install `.deb` files manually:

<!-- markdownlint-disable-next-line -->
1. Go to [`{{% param "download-url-base" %}}/dists/`]({{% param "download-url-base" %}}/dists/).

2. Select your Debian version in the list.
1. Select your Debian version in the list.

3. Go to `pool/stable/` and select the applicable architecture (`amd64`,
1. Go to `pool/stable/` and select the applicable architecture (`amd64`,
`armhf`, `arm64`, or `s390x`).

4. Download the following `deb` files for the Docker Engine, CLI, containerd,
1. Download the following `deb` files for the Docker Engine, CLI, containerd,
and Docker Compose packages:

- `containerd.io_<version>_<arch>.deb`
Expand All @@ -213,7 +202,7 @@ download a new file each time you want to upgrade Docker Engine.
- `docker-buildx-plugin_<version>_<arch>.deb`
- `docker-compose-plugin_<version>_<arch>.deb`

5. Install the `.deb` packages. Update the paths in the following example to
1. Install the `.deb` packages. Update the paths in the following example to
where you downloaded the Docker packages.

```console
Expand All @@ -226,7 +215,7 @@ download a new file each time you want to upgrade Docker Engine.

The Docker daemon starts automatically.

6. Verify that the installation is successful by running the `hello-world` image:
1. Verify that the installation is successful by running the `hello-world` image:

```console
$ sudo service docker start
Expand Down Expand Up @@ -255,15 +244,15 @@ To upgrade Docker Engine, download the newer package files and repeat the
$ sudo apt-get purge docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin docker-ce-rootless-extras
```

2. Images, containers, volumes, or custom configuration files on your host
1. Images, containers, volumes, or custom configuration files on your host
aren't automatically removed. To delete all images, containers, and volumes:

```console
$ sudo rm -rf /var/lib/docker
$ sudo rm -rf /var/lib/containerd
```

3. Remove source list and keyrings
1. Remove source list and keyrings

```console
$ sudo rm /etc/apt/sources.list.d/docker.list
Expand Down
Loading