diff --git a/content/manuals/engine/_index.md b/content/manuals/engine/_index.md index febf3717d81..0b000f61229 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 @@ -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. diff --git a/content/manuals/engine/install/_index.md b/content/manuals/engine/install/_index.md index cf03b08c40a..a192e3a6a8f 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,20 +54,16 @@ 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. +> 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 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 @@ -75,12 +71,11 @@ see: [Overview of Docker Desktop](/manuals/desktop/_index.md). 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 @@ -101,7 +96,7 @@ For information about the open source project, refer to the ### 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 @@ -111,11 +106,11 @@ 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 diff --git a/content/manuals/engine/install/centos.md b/content/manuals/engine/install/centos.md index d01ae2aaef4..18332a87db6 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,15 @@ 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. - -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 \ @@ -55,36 +54,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 - [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. ```console $ sudo dnf -y install dnf-plugins-core @@ -144,7 +132,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,16 +142,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 +161,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 +175,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 +217,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 diff --git a/content/manuals/engine/install/debian.md b/content/manuals/engine/install/debian.md index 0ca59c2490a..00e65bf4ab6 100644 --- a/content/manuals/engine/install/debian.md +++ b/content/manuals/engine/install/debian.md @@ -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) @@ -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` @@ -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 @@ -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" >}} @@ -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 @@ -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: 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 +202,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 +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 @@ -255,7 +244,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 +252,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 diff --git a/content/manuals/engine/install/fedora.md b/content/manuals/engine/install/fedora.md index a81766f0523..f1f760e4d82 100644 --- a/content/manuals/engine/install/fedora.md +++ b/content/manuals/engine/install/fedora.md @@ -15,27 +15,25 @@ 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 provided +by your Linux distribution before installing Docker Engine. +Remove the following packages if present: ```console $ sudo dnf remove docker \ @@ -141,7 +139,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 +149,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 +178,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 +188,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 +198,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 +227,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 diff --git a/content/manuals/engine/install/raspberry-pi-os.md b/content/manuals/engine/install/raspberry-pi-os.md index 1399c73ce07..15eaf34456d 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 f76d01be5ce..fa8545c3f6d 100644 --- a/content/manuals/engine/install/rhel.md +++ b/content/manuals/engine/install/rhel.md @@ -18,27 +18,25 @@ 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 ### 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 \ @@ -144,7 +142,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 +152,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 +179,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 +193,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 +207,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 +217,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 +246,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 diff --git a/content/manuals/engine/install/sles.md b/content/manuals/engine/install/sles.md index d32163c93fa..f49068b1320 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,11 +51,9 @@ $ sudo zypper addrepo $opensuse_repo ### 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 zypper remove docker \ @@ -76,7 +67,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 +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 ``` @@ -160,11 +150,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 +164,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 +193,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 +203,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 +213,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 +242,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