From f27edb7f7a2a698d8c5967fa65eaa8f39a9cc080 Mon Sep 17 00:00:00 2001 From: Sebastiaan van Stijn Date: Wed, 3 May 2023 15:31:28 +0200 Subject: [PATCH] engine/install: fix indentation, and align rerequisites section Signed-off-by: Sebastiaan van Stijn --- engine/install/centos.md | 130 ++++++++++++++++----------------- engine/install/fedora.md | 147 ++++++++++++++++++------------------- engine/install/rhel.md | 152 ++++++++++++++++++++------------------- engine/install/sles.md | 151 +++++++++++++++++++------------------- engine/install/ubuntu.md | 20 +++--- 5 files changed, 304 insertions(+), 296 deletions(-) diff --git a/engine/install/centos.md b/engine/install/centos.md index 66b8230df6..4a14e527e1 100644 --- a/engine/install/centos.md +++ b/engine/install/centos.md @@ -22,12 +22,12 @@ To get started with Docker Engine on CentOS, make sure you ### OS requirements -To install Docker Engine, you need a maintained version of one of the following CentOS versions: - - CentOS 7 - - CentOS 8 (stream) - - CentOS 9 (stream) +To install Docker Engine, you need a maintained version of one of the following +CentOS versions: -Archived versions aren't supported or tested. +- CentOS 7 +- CentOS 8 (stream) +- CentOS 9 (stream) The `centos-extras` repository must be enabled. This repository is enabled by default, but if you have disabled it, you need to @@ -102,46 +102,46 @@ $ sudo yum-config-manager --add-repo {{ download-url-base }}/docker-ce.repo
- To install the latest version, run: + To install the latest version, run: - ```console - $ sudo yum install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin - ``` + ```console + $ sudo yum install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin + ``` - If prompted to accept the GPG key, verify that the fingerprint matches - `060A 61C5 1B55 8A7F 742B 77AA C52F EB6B 621E 9F35`, and if so, accept it. + If prompted to accept the GPG key, verify that the fingerprint matches + `060A 61C5 1B55 8A7F 742B 77AA C52F EB6B 621E 9F35`, and if so, accept it. - 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 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.
- To install a specific version, start by listing the available versions in the repository: + To install a specific version, start by listing the available versions in the repository: - ```console - $ yum list docker-ce --showduplicates | sort -r + ```console + $ yum list docker-ce --showduplicates | sort -r - docker-ce.x86_64 3:23.0.5-1.el8 docker-ce-stable - docker-ce.x86_64 3:23.0.4-1.el8 docker-ce-stable - <...> - ``` + docker-ce.x86_64 3:23.0.5-1.el8 docker-ce-stable + docker-ce.x86_64 3:23.0.4-1.el8 docker-ce-stable + <...> + ``` - The list returned depends on which repositories are enabled, and is specific - to your version of CentOS (indicated by the `.el8` suffix in this example). + The list returned depends on which repositories are enabled, and is specific + to your version of CentOS (indicated by the `.el8` 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:23.0.5-1.el8`. + 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:23.0.5-1.el8`. - Replace `` with the desired version and then run the following command to install: + Replace `` with the desired version and then run the following command to install: - ```console - $ sudo yum install docker-ce- docker-ce-cli- containerd.io docker-buildx-plugin docker-compose-plugin - ``` + ```console + $ sudo yum 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 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.
@@ -149,19 +149,19 @@ $ sudo yum-config-manager --add-repo {{ download-url-base }}/docker-ce.repo 2. Start Docker. - ```console - $ sudo systemctl start docker - ``` + ```console + $ sudo systemctl start docker + ``` 3. Verify that Docker Engine installation is successful by running the `hello-world` - image. + image. - ```console - $ sudo docker run hello-world - ``` + ```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 command 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. @@ -179,33 +179,33 @@ If you can't use Docker's repository to install Docker, you can download the a new file each time you want to upgrade Docker Engine. 1. Go to [{{ download-url-base }}/]({{ download-url-base }}/){: target="_blank" rel="noopener" class="_" } - and choose your version of CentOS. Then browse to `x86_64/stable/Packages/` - and download the `.rpm` file for the Docker version you want to install. + and choose your version of CentOS. 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 path below to the path where you downloaded the Docker package. - ```console - $ sudo yum install /path/to/package.rpm - ``` + ```console + $ sudo yum 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. - ```console - $ sudo systemctl start docker - ``` + ```console + $ sudo systemctl start docker + ``` 4. Verify that Docker Engine installation is successful by running the `hello-world` - image. + image. - ```console - $ sudo docker run hello-world - ``` + ```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 command 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. @@ -223,18 +223,18 @@ instead of `yum -y install`, and point to the new file. 1. Uninstall the Docker Engine, CLI, containerd, and Docker Compose packages: - ```console - $ sudo yum remove docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin docker-ce-rootless-extras - ``` + ```console + $ sudo yum remove docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin docker-ce-rootless-extras + ``` 2. Images, containers, volumes, or customized configuration files on your host - are not automatically removed. To delete all images, containers, and - volumes: + are not automatically removed. To delete all images, containers, and + volumes: - ```console - $ sudo rm -rf /var/lib/docker - $ sudo rm -rf /var/lib/containerd - ``` + ```console + $ sudo rm -rf /var/lib/docker + $ sudo rm -rf /var/lib/containerd + ``` You must delete any edited configuration files manually. diff --git a/engine/install/fedora.md b/engine/install/fedora.md index 13aae898ab..838fc4c0eb 100644 --- a/engine/install/fedora.md +++ b/engine/install/fedora.md @@ -18,7 +18,8 @@ To get started with Docker Engine on Fedora, make sure you ### OS requirements -To install Docker Engine, you need the 64-bit version of one of these Fedora versions: +To install Docker Engine, you need a maintained version of one of the following +Fedora versions: - Fedora 36 - Fedora 37 @@ -84,62 +85,62 @@ $ sudo dnf config-manager --add-repo {{ download-url-base }}/docker-ce.repo #### Install Docker Engine -1. Install the _latest version_ of Docker Engine, containerd, and Docker Compose - or go to the next step to install a specific version: +1. Install the _latest version_ of Docker Engine, containerd, and Docker Compose + or go to the next step to install a specific version: - ```console - $ sudo dnf install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin - ``` + ```console + $ sudo dnf install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin + ``` - If prompted to accept the GPG key, verify that the fingerprint matches - `060A 61C5 1B55 8A7F 742B 77AA C52F EB6B 621E 9F35`, and if so, accept it. + If prompted to accept the GPG key, verify that the fingerprint matches + `060A 61C5 1B55 8A7F 742B 77AA C52F EB6B 621E 9F35`, and if so, accept it. - 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 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. -2. To install a _specific version_ of Docker Engine, list the available versions - in the repo, then select and install: +2. To install a _specific version_ of Docker Engine, list the available versions + in the repo, then select and install: - a. List and sort the versions available in your repo. This example sorts - results by version number, highest to lowest, and is truncated: + a. List and sort the versions available in your repo. This example sorts + results by version number, highest to lowest, and is truncated: - ```console - $ dnf list docker-ce --showduplicates | sort -r + ```console + $ dnf list docker-ce --showduplicates | sort -r - docker-ce.x86_64 3:23.0.5-1.fc37 docker-ce-stable - docker-ce.x86_64 3:23.0.4-1.fc37 docker-ce-stable - <...> - ``` + docker-ce.x86_64 3:23.0.5-1.fc37 docker-ce-stable + docker-ce.x86_64 3:23.0.4-1.fc37 docker-ce-stable + <...> + ``` - The list returned depends on which repositories are enabled, and is specific - to your version of Fedora (indicated by the `.fc37` suffix in this example). + The list returned depends on which repositories are enabled, and is specific + to your version of Fedora (indicated by the `.fc37` suffix in this example). - b. 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:23.0.5-1.fc37`. + b. 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:23.0.5-1.fc37`. - ```console - $ sudo dnf -y install docker-ce- docker-ce-cli- containerd.io docker-buildx-plugin docker-compose-plugin - ``` + ```console + $ sudo dnf -y 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 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. -3. Start Docker. +3. Start Docker. - ```console - $ sudo systemctl start docker - ``` + ```console + $ sudo systemctl start docker + ``` -4. Verify that Docker Engine is installed correctly by running the `hello-world` - image. +4. Verify that Docker Engine is installed correctly by running the `hello-world` + image. - ```console - $ sudo docker run hello-world - ``` + ```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 message and exits. + This command downloads a test image and runs it in a container. When the + container runs, it prints a message and exits. You have now successfully installed and started Docker Engine. @@ -156,35 +157,35 @@ If you cannot use Docker's repository to install Docker, 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. -1. Go to [{{ download-url-base }}/]({{ download-url-base }}/){: target="_blank" rel="noopener" class="_" } - 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. +1. Go to [{{ download-url-base }}/]({{ download-url-base }}/){: target="_blank" rel="noopener" class="_" } + 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 path below to the path where you downloaded - the Docker package. +2. Install Docker Engine, changing the path below to the path where you downloaded + the Docker package. - ```console - $ sudo dnf -y install /path/to/package.rpm - ``` + ```console + $ sudo dnf -y 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. +3. Start Docker. - ```console - $ sudo systemctl start docker - ``` + ```console + $ sudo systemctl start docker + ``` -4. Verify that Docker Engine is installed correctly by running the `hello-world` - image. +4. Verify that Docker Engine is installed correctly by running the `hello-world` + image. - ```console - $ sudo docker run hello-world - ``` + ```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 message and exits. + This command downloads a test image and runs it in a container. When the + container runs, it prints a message and exits. You have now successfully installed and started Docker Engine. @@ -200,20 +201,20 @@ instead of `dnf -y install`, and point to the new file. ## Uninstall Docker Engine -1. Uninstall the Docker Engine, CLI, Containerd, and Docker Compose packages: +1. Uninstall the Docker Engine, CLI, Containerd, and Docker Compose packages: - ```console - $ sudo dnf remove docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin docker-ce-rootless-extras - ``` + ```console + $ 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 customized configuration files on your host - are not automatically removed. To delete all images, containers, and - volumes: +2. Images, containers, volumes, or customized configuration files on your host + are not automatically removed. To delete all images, containers, and + volumes: - ```console - $ sudo rm -rf /var/lib/docker - $ sudo rm -rf /var/lib/containerd - ``` + ```console + $ sudo rm -rf /var/lib/docker + $ sudo rm -rf /var/lib/containerd + ``` You must delete any edited configuration files manually. diff --git a/engine/install/rhel.md b/engine/install/rhel.md index 74403cbf5b..6f7502098f 100644 --- a/engine/install/rhel.md +++ b/engine/install/rhel.md @@ -28,8 +28,12 @@ To get started with Docker Engine on RHEL, make sure you ### OS requirements -To install Docker Engine, you need a maintained version of RHEL 7, RHEL 8 or RHEL 9 on s390x (IBM Z). -Archived versions aren't supported or tested. +To install Docker Engine, you need a maintained version of one of the following +RHEL versions: + +- RHEL 7 on s390x (IBM Z) +- RHEL 8 on s390x (IBM Z) +- RHEL 9 on s390x (IBM Z) The `overlay2` storage driver is recommended. @@ -94,62 +98,62 @@ $ sudo yum-config-manager --add-repo {{ download-url-base }}/docker-ce.repo #### Install Docker Engine -1. Install the _latest version_ of Docker Engine, containerd, and Docker Compose - or go to the next step to install a specific version: +1. Install the _latest version_ of Docker Engine, containerd, and Docker Compose + or go to the next step to install a specific version: - ```console - $ sudo yum install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin - ``` + ```console + $ sudo yum install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin + ``` - If prompted to accept the GPG key, verify that the fingerprint matches - `060A 61C5 1B55 8A7F 742B 77AA C52F EB6B 621E 9F35`, and if so, accept it. + If prompted to accept the GPG key, verify that the fingerprint matches + `060A 61C5 1B55 8A7F 742B 77AA C52F EB6B 621E 9F35`, and if so, accept it. - 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 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. -2. To install a _specific version_ of Docker Engine, list the available versions - in the repo, then select and install: +2. To install a _specific version_ of Docker Engine, list the available versions + in the repo, then select and install: - a. List and sort the versions available in your repo. This example sorts - results by version number, highest to lowest, and is truncated: + a. List and sort the versions available in your repo. This example sorts + results by version number, highest to lowest, and is truncated: - ```console - $ yum list docker-ce --showduplicates | sort -r + ```console + $ yum list docker-ce --showduplicates | sort -r - docker-ce.s390x 3:23.0.5-1.el8 docker-ce-stable - docker-ce.s390x 3:23.0.4-1.el8 docker-ce-stable - <...> - ``` + docker-ce.s390x 3:23.0.5-1.el8 docker-ce-stable + docker-ce.s390x 3:23.0.4-1.el8 docker-ce-stable + <...> + ``` - The list returned depends on which repositories are enabled, and is specific - to your version of RHEL (indicated by the `.el8` suffix in this example). + The list returned depends on which repositories are enabled, and is specific + to your version of RHEL (indicated by the `.el8` suffix in this example). - b. 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:23.0.5-1.el8`. + b. 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:23.0.5-1.el8`. - ```console - $ sudo yum install docker-ce- docker-ce-cli- containerd.io docker-buildx-plugin docker-compose-plugin - ``` + ```console + $ sudo yum 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 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. -3. Start Docker. +3. Start Docker. - ```console - $ sudo systemctl start docker - ``` + ```console + $ sudo systemctl start docker + ``` -4. Verify that Docker Engine is installed correctly by running the `hello-world` - image. +4. Verify that Docker Engine is installed correctly by running the `hello-world` + image. - ```console - $ sudo docker run hello-world - ``` + ```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 message and exits. + This command downloads a test image and runs it in a container. When the + container runs, it prints a message and exits. You have now successfully installed and started Docker Engine. @@ -166,35 +170,35 @@ If you cannot use Docker's repository to install Docker, 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. -1. Go to [{{ download-url-base }}/]({{ download-url-base }}/){: target="_blank" rel="noopener" class="_" } - and choose your version of RHEL. Then browse to `s390x/stable/Packages/` - and download the `.rpm` file for the Docker version you want to install. +1. Go to [{{ download-url-base }}/]({{ download-url-base }}/){: target="_blank" rel="noopener" class="_" } + and choose your version of RHEL. 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 path below to the path where you downloaded - the Docker package. +2. Install Docker Engine, changing the path below to the path where you downloaded + the Docker package. - ```console - $ sudo yum install /path/to/package.rpm - ``` + ```console + $ sudo yum 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. +3. Start Docker. - ```console - $ sudo systemctl start docker - ``` + ```console + $ sudo systemctl start docker + ``` -4. Verify that Docker Engine is installed correctly by running the `hello-world` - image. +4. Verify that Docker Engine is installed correctly by running the `hello-world` + image. - ```console - $ sudo docker run hello-world - ``` + ```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 message and exits. + This command downloads a test image and runs it in a container. When the + container runs, it prints a message and exits. You have now successfully installed and started Docker Engine. @@ -210,20 +214,20 @@ instead of `yum -y install`, and point to the new file. ## Uninstall Docker Engine -1. Uninstall the Docker Engine, CLI, Containerd, and Docker Compose packages: +1. Uninstall the Docker Engine, CLI, Containerd, and Docker Compose packages: - ```console - $ sudo yum remove docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin docker-ce-rootless-extras - ``` + ```console + $ sudo yum remove docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin docker-ce-rootless-extras + ``` -2. Images, containers, volumes, or customized configuration files on your host - are not automatically removed. To delete all images, containers, and - volumes: +2. Images, containers, volumes, or customized configuration files on your host + are not automatically removed. To delete all images, containers, and + volumes: - ```console - $ sudo rm -rf /var/lib/docker - $ sudo rm -rf /var/lib/containerd - ``` + ```console + $ sudo rm -rf /var/lib/docker + $ sudo rm -rf /var/lib/containerd + ``` You must delete any edited configuration files manually. diff --git a/engine/install/sles.md b/engine/install/sles.md index e314e79840..008e4be5a3 100644 --- a/engine/install/sles.md +++ b/engine/install/sles.md @@ -34,8 +34,11 @@ To get started with Docker Engine on SLES, make sure you ### OS requirements -To install Docker Engine, you need a maintained version of SLES 15-SP3 or SLES 15-SP4 on s390x (IBM Z). -Archived versions aren't supported or tested. +To install Docker Engine, you need a maintained version of one of the following +SLES versions: + +- SLES 15-SP3 on s390x (IBM Z) +- SLES 15-SP4 on s390x (IBM Z) The [`SCC SUSE`](https://scc.suse.com/packages?name=SUSE%20Linux%20Enterprise%20Server&version=15.3&arch=s390x) repositories must be enabled. @@ -117,61 +120,61 @@ $ sudo zypper addrepo {{ download-url-base }}/docker-ce.repo #### Install Docker Engine -1. Install the _latest version_ of Docker Engine, containerd, and Docker Compose - or go to the next step to install a specific version: +1. Install the _latest version_ of Docker Engine, containerd, and Docker Compose + or go to the next step to install a specific version: - ```console - $ sudo zypper install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin - ``` + ```console + $ sudo zypper install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin + ``` - If prompted to accept the GPG key, verify that the fingerprint matches - `060A 61C5 1B55 8A7F 742B 77AA C52F EB6B 621E 9F35`, and if so, accept it. + If prompted to accept the GPG key, verify that the fingerprint matches + `060A 61C5 1B55 8A7F 742B 77AA C52F EB6B 621E 9F35`, and if so, accept it. - 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 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. -2. To install a _specific version_ of Docker Engine, list the available versions - in the repo, then select and install: +2. To install a _specific version_ of Docker Engine, list the available versions + in the repo, then select and install: - a. List and sort the versions available in your repo. This example sorts - results by version number, highest to lowest, and is truncated: + a. List and sort the versions available in your repo. This example sorts + results by version number, highest to lowest, and is truncated: - ```console - $ sudo zypper search -s --match-exact docker-ce | sort -r - - v | docker-ce | package | 3:23.0.5-3 | s390x | Docker CE Stable - s390x - v | docker-ce | package | 3:23.0.4-3 | s390x | Docker CE Stable - s390x - ``` + ```console + $ sudo zypper search -s --match-exact docker-ce | sort -r + + v | docker-ce | package | 3:23.0.5-3 | s390x | Docker CE Stable - s390x + v | docker-ce | package | 3:23.0.4-3 | s390x | Docker CE Stable - s390x + ``` - The list returned depends on which repositories are enabled, and is specific - to your version of SLES. + The list returned depends on which repositories are enabled, and is specific + to your version of SLES. - b. Install a specific version by its fully qualified package name, which is - the package name (`docker-ce`) plus the version string (fourth column), - separated by a hyphen (`-`). For example, `docker-ce-3:23.0.5`. + b. Install a specific version by its fully qualified package name, which is + the package name (`docker-ce`) plus the version string (fourth column), + separated by a hyphen (`-`). For example, `docker-ce-3:23.0.5`. - ```console - $ sudo zypper install docker-ce- docker-ce-cli- containerd.io docker-buildx-plugin docker-compose-plugin - ``` + ```console + $ sudo zypper 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 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. -3. Start Docker. +3. Start Docker. - ```console - $ sudo systemctl start docker - ``` + ```console + $ sudo systemctl start docker + ``` -4. Verify that Docker Engine is installed correctly by running the `hello-world` - image. +4. Verify that Docker Engine is installed correctly by running the `hello-world` + image. - ```console - $ sudo docker run hello-world - ``` + ```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 message and exits. + This command downloads a test image and runs it in a container. When the + container runs, it prints a message and exits. You have now successfully installed and started Docker Engine. @@ -188,35 +191,35 @@ If you cannot use Docker's repository to install Docker, 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. -1. Go to [{{ download-url-base }}/]({{ download-url-base }}/){: target="_blank" rel="noopener" class="_" } - and choose your version of SLES. Then browse to `15/s390x/stable/Packages/` - and download the `.rpm` file for the Docker version you want to install. +1. Go to [{{ download-url-base }}/]({{ download-url-base }}/){: target="_blank" rel="noopener" class="_" } + and choose your version of SLES. Then browse to `15/s390x/stable/Packages/` + and download the `.rpm` file for the Docker version you want to install. -2. Install Docker Engine, changing the path below to the path where you downloaded - the Docker package. +2. Install Docker Engine, changing the path below to the path where you downloaded + the Docker package. - ```console - $ sudo zypper install /path/to/package.rpm - ``` + ```console + $ sudo zypper 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. +3. Start Docker. - ```console - $ sudo systemctl start docker - ``` + ```console + $ sudo systemctl start docker + ``` -4. Verify that Docker Engine is installed correctly by running the `hello-world` - image. +4. Verify that Docker Engine is installed correctly by running the `hello-world` + image. - ```console - $ sudo docker run hello-world - ``` + ```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 message and exits. + This command downloads a test image and runs it in a container. When the + container runs, it prints a message and exits. You have now successfully installed and started Docker Engine. @@ -232,20 +235,20 @@ instead of `zypper -y install`, and point to the new file. ## Uninstall Docker Engine -1. Uninstall the Docker Engine, CLI, Containerd, and Docker Compose packages: +1. Uninstall the Docker Engine, CLI, Containerd, and Docker Compose packages: - ```console - $ sudo zypper remove docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin docker-ce-rootless-extras - ``` + ```console + $ 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 customized configuration files on your host - are not automatically removed. To delete all images, containers, and - volumes: +2. Images, containers, volumes, or customized configuration files on your host + are not automatically removed. To delete all images, containers, and + volumes: - ```console - $ sudo rm -rf /var/lib/docker - $ sudo rm -rf /var/lib/containerd - ``` + ```console + $ sudo rm -rf /var/lib/docker + $ sudo rm -rf /var/lib/containerd + ``` You must delete any edited configuration files manually. diff --git a/engine/install/ubuntu.md b/engine/install/ubuntu.md index 909dec2ef8..3dc266c167 100644 --- a/engine/install/ubuntu.md +++ b/engine/install/ubuntu.md @@ -235,19 +235,19 @@ To upgrade Docker Engine, download the newer package files and repeat the ## Uninstall Docker Engine -1. Uninstall the Docker Engine, CLI, containerd, and Docker Compose packages: +1. Uninstall the Docker Engine, CLI, containerd, and Docker Compose packages: - ```console - $ sudo apt-get purge docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin docker-ce-rootless-extras - ``` + ```console + $ 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 - aren't automatically removed. To delete all images, containers, and volumes: +2. 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 - ``` + ```console + $ sudo rm -rf /var/lib/docker + $ sudo rm -rf /var/lib/containerd + ``` You have to delete any edited configuration files manually.