From 2585291afb4e1a4bd2247cf2fda5d18152f7ffea Mon Sep 17 00:00:00 2001 From: Arthur Date: Mon, 21 Jul 2025 14:53:51 +0200 Subject: [PATCH 1/8] engine --- content/manuals/engine/_index.md | 19 +++++++------------ 1 file changed, 7 insertions(+), 12 deletions(-) diff --git a/content/manuals/engine/_index.md b/content/manuals/engine/_index.md index febf3717d814..726b17be5064 100644 --- a/content/manuals/engine/_index.md +++ b/content/manuals/engine/_index.md @@ -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 @@ -51,16 +51,11 @@ aliases: - /linux/ --- -Docker Engine is an open source containerization technology for building and -containerizing your applications. Docker Engine acts as a client-server -application with: +Docker Engine is an open source containerization technology for building and containerizing your applications. Docker Engine acts as a client-server application with: -- A server with a long-running daemon process - [`dockerd`](/reference/cli/dockerd). -- APIs which specify interfaces that programs can use to talk to and instruct - the Docker daemon. -- A command line interface (CLI) client - [`docker`](/reference/cli/docker/). +- A server with a long-running daemon process [`dockerd`](/reference/cli/dockerd) +- APIs that specify interfaces that programs can use to talk to and instruct the Docker daemon +- A command line interface (CLI) client [`docker`](/reference/cli/docker/) The CLI uses [Docker APIs](/reference/api/engine/_index.md) to control or interact with the Docker daemon through scripting or direct CLI commands. Many other Docker applications @@ -76,6 +71,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. From a81a152e07c8e8a7ced032de8420bd1e4703d765 Mon Sep 17 00:00:00 2001 From: Arthur Date: Mon, 21 Jul 2025 15:13:55 +0200 Subject: [PATCH 2/8] install --- content/manuals/engine/install/_index.md | 77 +++++++++--------------- 1 file changed, 29 insertions(+), 48 deletions(-) diff --git a/content/manuals/engine/install/_index.md b/content/manuals/engine/install/_index.md index cf03b08c40ae..dc57798d763d 100644 --- a/content/manuals/engine/install/_index.md +++ b/content/manuals/engine/install/_index.md @@ -33,10 +33,10 @@ aliases: - /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. + +> [!TIP] +> To install Docker Desktop, see [Overview of Docker Desktop](/manuals/desktop/_index.md). ## Supported platforms @@ -54,70 +54,51 @@ see: [Overview of Docker Desktop](/manuals/desktop/_index.md). ### 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. -- 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. +> 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): + - 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): + - 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 Docker Engine package in their repositories. These packages are built and maintained by the distribution's maintainers and may have configuration differences or use modified source code. Docker isn't involved in releasing these packages. Report bugs or issues with these packages to your distribution's issue tracker. + +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 - general availability. +- 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 general availability. -Use the test channel with caution. Pre-release versions include experimental and -early-access features that are subject to breaking changes. +Use the test channel with caution. Pre-release versions include experimental and early-access features that are subject to breaking changes. ## Support -Docker Engine is an open source project, supported by the Moby project maintainers -and community members. Docker doesn't provide support for Docker Engine. -Docker provides support for Docker products, including Docker Desktop, which uses -Docker Engine as one of its components. +Docker Engine is an open source project, supported by the Moby project maintainers and community members. Docker doesn't provide support for Docker Engine. Docker provides support for Docker products, including Docker Desktop, which uses Docker Engine as one of its components. -For information about the open source project, refer to the -[Moby project website](https://mobyproject.org/). +For information about the open source project, refer to the [Moby project website](https://mobyproject.org/). ### 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 -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. +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. ## 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 security@docker.com. +Do not file a public issue. Instead, send your report privately to security@docker.com. -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 -After setting up Docker, you can learn the basics with -[Getting started with Docker](/get-started/introduction/_index.md). +After setting up Docker, you can learn the basics with [Getting started with Docker](/get-started/introduction/_index.md). From fd57681b7577854744d4f8839e8edd42f1942d22 Mon Sep 17 00:00:00 2001 From: Arthur Date: Mon, 21 Jul 2025 15:22:08 +0200 Subject: [PATCH 3/8] centos --- content/manuals/engine/install/centos.md | 82 +++++++++--------------- 1 file changed, 32 insertions(+), 50 deletions(-) diff --git a/content/manuals/engine/install/centos.md b/content/manuals/engine/install/centos.md index d01ae2aaef41..17501e8d09c8 100644 --- a/content/manuals/engine/install/centos.md +++ b/content/manuals/engine/install/centos.md @@ -19,7 +19,7 @@ download-url-base: https://download.docker.com/linux/centos --- 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 @@ -31,16 +31,17 @@ CentOS versions: - 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. +Before you install Docker Engine, 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. +Your Linux distribution may provide unofficial Docker packages, which can +conflict with the official packages provided by Docker. Uninstall these packages +before installing the official version. ```console $ sudo dnf remove docker \ @@ -55,36 +56,25 @@ $ sudo dnf remove docker \ `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 install Docker Engine in different ways: -- 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. - -- 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. ```console $ sudo dnf -y install dnf-plugins-core @@ -93,12 +83,10 @@ $ sudo dnf config-manager --add-repo {{% param "download-url-base" %}}/docker-ce #### Install Docker Engine -1. Install the Docker packages. +{{< tabs >}} +{{< tab name="Latest" >}} - {{< tabs >}} - {{< tab name="Latest" >}} - - To install the latest version, run: +To install the latest version: ```console $ sudo dnf install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin @@ -124,27 +112,24 @@ $ sudo dnf config-manager --add-repo {{% param "download-url-base" %}}/docker-ce <...> ``` - The list returned depends on which repositories are enabled, and is specific - to your version of CentOS (indicated by the `.el9` suffix in this example). + The list depends on which repositories are enabled and your CentOS version (see the `.el9` suffix). Install a specific version by its fully qualified package name, which is the package name (`docker-ce`) plus the version string (2nd column), separated by a hyphen (`-`). For example, `docker-ce-3:{{% param "docker_ce_version" %}}-1.el9`. - Replace `` with the desired version and then run the following - command to install: + Replace `` with the desired version and run: ```console $ sudo dnf install docker-ce- docker-ce-cli- containerd.io docker-buildx-plugin docker-compose-plugin ``` - This command installs Docker, but it doesn't start Docker. It also creates a - `docker` group, however, it doesn't add any users to the group by default. + This installs Docker, but does not start it. It also creates a `docker` group, but does not add users to the group by default. {{< /tab >}} {{< /tabs >}} -2. Start Docker Engine. +1. Start Docker Engine: ```console $ sudo systemctl enable --now docker @@ -154,16 +139,15 @@ $ sudo dnf config-manager --add-repo {{% param "download-url-base" %}}/docker-ce 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" %}} @@ -174,9 +158,7 @@ choosing the new version you want to install. ### 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. 1. Go to [{{% param "download-url-base" %}}/]({{% param "download-url-base" %}}/) @@ -190,10 +172,10 @@ download a new file each time you want to upgrade Docker Engine. $ 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 @@ -232,7 +214,7 @@ instead of `dnf install`, and point to the new files. $ 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 From d24440e83aa23970b3c4176d302ab2b7cdd3d28d Mon Sep 17 00:00:00 2001 From: Arthur Date: Mon, 21 Jul 2025 15:41:18 +0200 Subject: [PATCH 4/8] debian --- content/manuals/engine/install/debian.md | 63 +++++++++--------------- 1 file changed, 23 insertions(+), 40 deletions(-) diff --git a/content/manuals/engine/install/debian.md b/content/manuals/engine/install/debian.md index 0ca59c2490a8..0b4f22521474 100644 --- a/content/manuals/engine/install/debian.md +++ b/content/manuals/engine/install/debian.md @@ -22,25 +22,16 @@ To get started with Docker Engine on Debian, make sure you ### Firewall limitations -> [!WARNING] -> -> 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) @@ -51,13 +42,8 @@ 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 before installing Docker Engine. +Remove the following packages if present: - `docker.io` - `docker-compose` @@ -75,12 +61,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 @@ -135,7 +120,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" >}} @@ -171,7 +156,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 @@ -192,19 +177,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: 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__.deb` @@ -213,7 +196,7 @@ download a new file each time you want to upgrade Docker Engine. - `docker-buildx-plugin__.deb` - `docker-compose-plugin__.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 @@ -226,7 +209,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 @@ -255,7 +238,7 @@ 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 @@ -263,7 +246,7 @@ To upgrade Docker Engine, download the newer package files and repeat the $ 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 From d45768e8f877f33960f5e0adbd47427a9c06c0c0 Mon Sep 17 00:00:00 2001 From: Arthur Date: Mon, 21 Jul 2025 15:48:26 +0200 Subject: [PATCH 5/8] fedora --- content/manuals/engine/install/fedora.md | 29 +++++++++++------------- 1 file changed, 13 insertions(+), 16 deletions(-) diff --git a/content/manuals/engine/install/fedora.md b/content/manuals/engine/install/fedora.md index a81766f05235..cb8ea8e21505 100644 --- a/content/manuals/engine/install/fedora.md +++ b/content/manuals/engine/install/fedora.md @@ -15,27 +15,24 @@ aliases: download-url-base: https://download.docker.com/linux/fedora --- -To get started with Docker Engine on Fedora, make sure you -[meet the prerequisites](#prerequisites), and then follow the -[installation steps](#installation-methods). +To get started with Docker Engine on Fedora: + +- [Check prerequisites](#prerequisites) +- [Follow the installation steps](#installation-methods) ## Prerequisites ### OS requirements -To install Docker Engine, you need a maintained version of one of the following -Fedora versions: +Docker Engine requires a maintained version of Fedora: - Fedora 42 - Fedora 41 ### 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 before installing Docker Engine. +Remove the following packages if present: ```console $ sudo dnf remove docker \ @@ -141,7 +138,7 @@ $ sudo dnf-3 config-manager --add-repo {{% param "download-url-base" %}}/docker- {{< /tab >}} {{< /tabs >}} -2. Start Docker Engine. +1. Start Docker Engine. ```console $ sudo systemctl enable --now docker @@ -151,7 +148,7 @@ $ sudo dnf-3 config-manager --add-repo {{% param "download-url-base" %}}/docker- 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 that the installation is successful by running the `hello-world` image: ```console $ sudo docker run hello-world @@ -180,7 +177,7 @@ download a new file each time you want to upgrade Docker Engine. and choose your version of Fedora. Then browse to `x86_64/stable/Packages/` and download the `.rpm` file for the Docker version you want to install. -2. Install Docker Engine, changing the following path to the path where you downloaded +1. Install Docker Engine, changing the following path to the path where you downloaded the Docker package. ```console @@ -190,7 +187,7 @@ download a new file each time you want to upgrade Docker Engine. Docker is installed but not started. The `docker` group is created, but no users are added to the group. -3. Start Docker Engine. +1. Start Docker Engine. ```console $ sudo systemctl enable --now docker @@ -200,7 +197,7 @@ download a new file each time you want to upgrade Docker Engine. boot your system. If you don't want Docker to start automatically, use `sudo systemctl start docker` instead. -4. 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 @@ -229,7 +226,7 @@ instead of `dnf install`, and point to the new files. $ 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 From 02d940447f8d3b5ee862773973c72194eb236d4e Mon Sep 17 00:00:00 2001 From: Arthur Date: Mon, 21 Jul 2025 15:51:28 +0200 Subject: [PATCH 6/8] rhel --- content/manuals/engine/install/rhel.md | 28 +++++++++++++------------- 1 file changed, 14 insertions(+), 14 deletions(-) diff --git a/content/manuals/engine/install/rhel.md b/content/manuals/engine/install/rhel.md index f76d01be5ce9..88d4eaaf41ef 100644 --- a/content/manuals/engine/install/rhel.md +++ b/content/manuals/engine/install/rhel.md @@ -18,16 +18,16 @@ aliases: download-url-base: https://download.docker.com/linux/rhel --- -To get started with Docker Engine on RHEL, make sure you -[meet the prerequisites](#prerequisites), and then follow the -[installation steps](#installation-methods). +To get started with Docker Engine on RHEL: + +- [Check prerequisites](#prerequisites) +- [Follow the installation steps](#installation-methods) ## Prerequisites ### OS requirements -To install Docker Engine, you need a maintained version of one of the following -RHEL versions: +Docker Engine requires a maintained version of RHEL: - RHEL 8 - RHEL 9 @@ -144,7 +144,7 @@ $ sudo dnf config-manager --add-repo {{% param "download-url-base" %}}/docker-ce {{< /tab >}} {{< /tabs >}} -2. Start Docker Engine. +1. Start Docker Engine. ```console $ sudo systemctl enable --now docker @@ -154,7 +154,7 @@ $ sudo dnf config-manager --add-repo {{% param "download-url-base" %}}/docker-ce 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 that the installation is successful by running the `hello-world` image: ```console $ sudo docker run hello-world @@ -181,12 +181,12 @@ download a new file each time you want to upgrade Docker Engine. 1. Go to [{{% param "download-url-base" %}}/]({{% param "download-url-base" %}}/). -2. Select your RHEL version in the list. +1. Select your RHEL version in the list. -3. Select the applicable architecture (`x86_64`, `aarch64`, or `s390x`), and +1. Select the applicable architecture (`x86_64`, `aarch64`, or `s390x`), and then go to `stable/Packages/`. -4. Download the following `rpm` files for the Docker Engine, CLI, containerd, +1. Download the following `rpm` files for the Docker Engine, CLI, containerd, and Docker Compose packages: - `containerd.io-..rpm` @@ -195,7 +195,7 @@ download a new file each time you want to upgrade Docker Engine. - `docker-buildx-plugin-..rpm` - `docker-compose-plugin-..rpm` -5. Install Docker Engine, changing the following path to the path where you downloaded +1. Install Docker Engine, changing the following path to the path where you downloaded the packages. ```console @@ -209,7 +209,7 @@ download a new file each time you want to upgrade Docker Engine. Docker is installed but not started. The `docker` group is created, but no users are added to the group. -6. Start Docker Engine. +1. Start Docker Engine. ```console $ sudo systemctl enable --now docker @@ -219,7 +219,7 @@ download a new file each time you want to upgrade Docker Engine. boot your system. If you don't want Docker to start automatically, use `sudo systemctl start docker` instead. -7. 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 @@ -248,7 +248,7 @@ instead of `dnf install`, and point to the new files. $ 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 From 00b0bf4ecf46a90bfac1ff0ccdca97a2d75afc8f Mon Sep 17 00:00:00 2001 From: Arthur Date: Mon, 21 Jul 2025 16:58:00 +0200 Subject: [PATCH 7/8] sles --- content/manuals/engine/install/sles.md | 37 +++++++++++--------------- 1 file changed, 15 insertions(+), 22 deletions(-) diff --git a/content/manuals/engine/install/sles.md b/content/manuals/engine/install/sles.md index d32163c93faa..d128412a27e4 100644 --- a/content/manuals/engine/install/sles.md +++ b/content/manuals/engine/install/sles.md @@ -27,29 +27,22 @@ download-url-base: https://download.docker.com/linux/sles --- > [!NOTE] -> -> The installation instructions on this page refer to packages for SLES on the -> **s390x** architecture (IBM Z). Other architectures, including x86_64, aren't -> supported for SLES. +> These instructions are for SLES on the **s390x** architecture (IBM Z). Other architectures, including x86_64, are not supported for SLES. -To get started with Docker Engine on SLES, make sure you -[meet the prerequisites](#prerequisites), and then follow the -[installation steps](#installation-methods). +To get started with Docker Engine on SLES, first [meet the prerequisites](#prerequisites). Then follow the [installation steps](#installation-methods). ## Prerequisites ### OS requirements -To install Docker Engine, you need a maintained version of one of the following -SLES versions: +You need a maintained version of one of these SLES versions: - SLES 15-SP4 on s390x (IBM Z) - SLES 15-SP5 on s390x (IBM Z) -You must enable the [`SCC SUSE`](https://scc.suse.com/packages?name=SUSE%20Linux%20Enterprise%20Server&version=15.5&arch=s390x) -repositories. +Enable the [`SCC SUSE`](https://scc.suse.com/packages?name=SUSE%20Linux%20Enterprise%20Server&version=15.5&arch=s390x) repositories. -You must add the [OpenSUSE `SELinux` repository](https://download.opensuse.org/repositories/security:/SELinux/). This repository is not added by default. Run the following commands to add it: +Add the [OpenSUSE SELinux repository](https://download.opensuse.org/repositories/security:/SELinux/). This repository is not added by default. Run: ```console $ opensuse_repo="https://download.opensuse.org/repositories/security:/SELinux/openSUSE_Factory/security:SELinux.repo" @@ -58,7 +51,7 @@ $ sudo zypper addrepo $opensuse_repo ### Uninstall old versions -Before you can install Docker Engine, you need to uninstall any conflicting packages. +Uninstall any conflicting packages before you install Docker Engine. Your Linux distribution may provide unofficial Docker packages, which may conflict with the official packages provided by Docker. You must uninstall these packages @@ -76,7 +69,7 @@ $ sudo zypper remove docker \ runc ``` -`zypper` might report that you have none of these packages installed. +`zypper` might report that none of these packages are installed. Images, containers, volumes, and networks stored in `/var/lib/docker/` aren't automatically removed when you uninstall Docker. @@ -139,7 +132,7 @@ $ sudo zypper addrepo {{% param "download-url-base" %}}/docker-ce.repo ```console $ sudo zypper search -s --match-exact docker-ce | sort -r - + v | docker-ce | package | 3:{{% param "docker_ce_version" %}}-1 | s390x | Docker CE Stable - s390x v | docker-ce | package | 3:{{% param "docker_ce_version_prev" %}}-1 | s390x | Docker CE Stable - s390x ``` @@ -160,11 +153,11 @@ $ sudo zypper addrepo {{% param "download-url-base" %}}/docker-ce.repo This command installs Docker, but it doesn't start Docker. It also creates a `docker` group, however, it doesn't add any users to the group by default. - + {{< /tab >}} {{< /tabs >}} -2. Start Docker Engine. +1. Start Docker Engine. ```console $ sudo systemctl enable --now docker @@ -174,7 +167,7 @@ $ sudo zypper addrepo {{% param "download-url-base" %}}/docker-ce.repo 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 that the installation is successful by running the `hello-world` image: ```console $ sudo docker run hello-world @@ -203,7 +196,7 @@ download a new file each time you want to upgrade Docker Engine. and choose your version of SLES. Then browse to `s390x/stable/Packages/` and download the `.rpm` file for the Docker version you want to install. -2. Install Docker Engine, changing the following path to the path where you downloaded +1. Install Docker Engine, changing the following path to the path where you downloaded the Docker package. ```console @@ -213,7 +206,7 @@ download a new file each time you want to upgrade Docker Engine. Docker is installed but not started. The `docker` group is created, but no users are added to the group. -3. Start Docker Engine. +1. Start Docker Engine. ```console $ sudo systemctl enable --now docker @@ -223,7 +216,7 @@ download a new file each time you want to upgrade Docker Engine. boot your system. If you don't want Docker to start automatically, use `sudo systemctl start docker` instead. -4. 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 @@ -252,7 +245,7 @@ instead of `zypper -y install`, and point to the new files. $ sudo zypper 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 From 82b8d28fe26b09447071a43403dbf7b6db0db2fb Mon Sep 17 00:00:00 2001 From: Arthur Date: Wed, 23 Jul 2025 11:14:09 +0200 Subject: [PATCH 8/8] tweaks --- content/manuals/engine/_index.md | 13 +++++--- content/manuals/engine/install/_index.md | 30 ++++++++++++++----- content/manuals/engine/install/centos.md | 25 +++++++++------- content/manuals/engine/install/debian.md | 20 ++++++++----- content/manuals/engine/install/fedora.md | 3 +- .../manuals/engine/install/raspberry-pi-os.md | 10 +++---- content/manuals/engine/install/rhel.md | 8 ++--- content/manuals/engine/install/sles.md | 9 ++---- 8 files changed, 70 insertions(+), 48 deletions(-) diff --git a/content/manuals/engine/_index.md b/content/manuals/engine/_index.md index 726b17be5064..0b000f612298 100644 --- a/content/manuals/engine/_index.md +++ b/content/manuals/engine/_index.md @@ -51,11 +51,16 @@ aliases: - /linux/ --- -Docker Engine is an open source containerization technology for building and containerizing your applications. Docker Engine acts as a client-server application with: +Docker Engine is an open source containerization technology for building and +containerizing your applications. Docker Engine acts as a client-server +application with: -- A server with a long-running daemon process [`dockerd`](/reference/cli/dockerd) -- APIs that specify interfaces that programs can use to talk to and instruct the Docker daemon -- A command line interface (CLI) client [`docker`](/reference/cli/docker/) +- A server with a long-running daemon process + [`dockerd`](/reference/cli/dockerd). +- APIs which specify interfaces that programs can use to talk to and instruct + the Docker daemon. +- A command line interface (CLI) client + [`docker`](/reference/cli/docker/). The CLI uses [Docker APIs](/reference/api/engine/_index.md) to control or interact with the Docker daemon through scripting or direct CLI commands. Many other Docker applications diff --git a/content/manuals/engine/install/_index.md b/content/manuals/engine/install/_index.md index dc57798d763d..a192e3a6a8f2 100644 --- a/content/manuals/engine/install/_index.md +++ b/content/manuals/engine/install/_index.md @@ -64,7 +64,12 @@ This section describes how to install Docker Engine on Linux, also known as Dock - 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 Docker Engine package in their repositories. These packages are built and maintained by the distribution's maintainers and may have configuration differences or use modified source code. Docker isn't involved in releasing these packages. Report bugs or issues with these packages to your distribution's issue tracker. +- 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. These binaries are statically linked and work on any Linux distribution. @@ -72,16 +77,22 @@ Docker provides [binaries](binaries.md) for manual installation. These binaries 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 general availability. +* 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 + general availability. -Use the test channel with caution. Pre-release versions include experimental and early-access features that are subject to breaking changes. +Use the test channel with caution. Pre-release versions include experimental and +early-access features that are subject to breaking changes. ## Support -Docker Engine is an open source project, supported by the Moby project maintainers and community members. Docker doesn't provide support for Docker Engine. Docker provides support for Docker products, including Docker Desktop, which uses Docker Engine as one of its components. +Docker Engine is an open source project, supported by the Moby project maintainers +and community members. Docker doesn't provide support for Docker Engine. +Docker provides support for Docker products, including Docker Desktop, which uses +Docker Engine as one of its components. -For information about the open source project, refer to the [Moby project website](https://mobyproject.org/). +For information about the open source project, refer to the +[Moby project website](https://mobyproject.org/). ### Upgrade path @@ -89,7 +100,9 @@ Patch releases are always backward compatible with their major and minor version ### Licensing -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. +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. ## Reporting security issues @@ -101,4 +114,5 @@ Docker appreciates security reports and will publicly thank you for your contrib ## Get started -After setting up Docker, you can learn the basics with [Getting started with Docker](/get-started/introduction/_index.md). +After setting up Docker, you can learn the basics with +[Getting started with Docker](/get-started/introduction/_index.md). diff --git a/content/manuals/engine/install/centos.md b/content/manuals/engine/install/centos.md index 17501e8d09c8..18332a87db67 100644 --- a/content/manuals/engine/install/centos.md +++ b/content/manuals/engine/install/centos.md @@ -37,11 +37,9 @@ CentOS versions: ### Uninstall old versions -Before you install Docker Engine, uninstall any conflicting packages. - -Your Linux distribution may provide unofficial Docker packages, which can -conflict with the official packages provided by Docker. Uninstall these packages -before installing the official version. +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 \ @@ -83,10 +81,12 @@ $ sudo dnf config-manager --add-repo {{% param "download-url-base" %}}/docker-ce #### Install Docker Engine -{{< tabs >}} -{{< tab name="Latest" >}} +1. Install the Docker packages. + + {{< tabs >}} + {{< tab name="Latest" >}} -To install the latest version: + To install the latest version, run: ```console $ sudo dnf install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin @@ -112,19 +112,22 @@ To install the latest version: <...> ``` - The list depends on which repositories are enabled and your CentOS version (see the `.el9` suffix). + The list returned depends on which repositories are enabled, and is specific + to your version of CentOS (indicated by the `.el9` suffix in this example). Install a specific version by its fully qualified package name, which is the package name (`docker-ce`) plus the version string (2nd column), separated by a hyphen (`-`). For example, `docker-ce-3:{{% param "docker_ce_version" %}}-1.el9`. - Replace `` with the desired version and run: + Replace `` with the desired version and then run the following + command to install: ```console $ sudo dnf install docker-ce- docker-ce-cli- containerd.io docker-buildx-plugin docker-compose-plugin ``` - This installs Docker, but does not start it. It also creates a `docker` group, but does not add users to the group by default. + This command installs Docker, but it doesn't start Docker. It also creates a + `docker` group, however, it doesn't add any users to the group by default. {{< /tab >}} {{< /tabs >}} diff --git a/content/manuals/engine/install/debian.md b/content/manuals/engine/install/debian.md index 0b4f22521474..00e65bf4ab6e 100644 --- a/content/manuals/engine/install/debian.md +++ b/content/manuals/engine/install/debian.md @@ -22,12 +22,17 @@ To get started with Docker Engine on Debian, make sure you ### Firewall limitations -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). +> [!WARNING] +> +> Before you install Docker, make sure you consider the following +> security implications and firewall incompatibilities. + +- 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 @@ -42,7 +47,8 @@ and ppc64le (ppc64el) architectures. ### Uninstall old versions -Uninstall unofficial or conflicting Docker packages before installing Docker Engine. +Uninstall unofficial or conflicting Docker packages provided +by your Linux distribution before installing Docker Engine. Remove the following packages if present: - `docker.io` diff --git a/content/manuals/engine/install/fedora.md b/content/manuals/engine/install/fedora.md index cb8ea8e21505..f1f760e4d821 100644 --- a/content/manuals/engine/install/fedora.md +++ b/content/manuals/engine/install/fedora.md @@ -31,7 +31,8 @@ Docker Engine requires a maintained version of Fedora: ### Uninstall old versions -Uninstall unofficial or conflicting Docker packages before installing Docker Engine. +Uninstall unofficial or conflicting Docker packages provided +by your Linux distribution before installing Docker Engine. Remove the following packages if present: ```console diff --git a/content/manuals/engine/install/raspberry-pi-os.md b/content/manuals/engine/install/raspberry-pi-os.md index 1399c73ce073..15eaf34456dc 100644 --- a/content/manuals/engine/install/raspberry-pi-os.md +++ b/content/manuals/engine/install/raspberry-pi-os.md @@ -51,11 +51,9 @@ To install Docker Engine, you need one of the following OS versions: ### 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: The unofficial packages to uninstall are: @@ -132,7 +130,7 @@ Docker from the repository. ```console $ sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin ``` - + {{< /tab >}} {{< tab name="Specific version" >}} diff --git a/content/manuals/engine/install/rhel.md b/content/manuals/engine/install/rhel.md index 88d4eaaf41ef..fa8545c3f6d9 100644 --- a/content/manuals/engine/install/rhel.md +++ b/content/manuals/engine/install/rhel.md @@ -34,11 +34,9 @@ Docker Engine requires a maintained version of RHEL: ### 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 \ diff --git a/content/manuals/engine/install/sles.md b/content/manuals/engine/install/sles.md index d128412a27e4..f49068b1320d 100644 --- a/content/manuals/engine/install/sles.md +++ b/content/manuals/engine/install/sles.md @@ -51,11 +51,9 @@ $ sudo zypper addrepo $opensuse_repo ### Uninstall old versions -Uninstall any conflicting packages before you install Docker Engine. - -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 zypper remove docker \ @@ -132,7 +130,6 @@ $ sudo zypper addrepo {{% param "download-url-base" %}}/docker-ce.repo ```console $ sudo zypper search -s --match-exact docker-ce | sort -r - v | docker-ce | package | 3:{{% param "docker_ce_version" %}}-1 | s390x | Docker CE Stable - s390x v | docker-ce | package | 3:{{% param "docker_ce_version_prev" %}}-1 | s390x | Docker CE Stable - s390x ```