- 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.
- To install a specific version of Docker Engine, start by list the available
+ To install a specific version of Docker Engine, start by listing the available
versions in the repository:
```console
@@ -174,7 +171,7 @@ Raspbian.
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.
+You have now successfully installed and started Docker Engine.
{% include root-errors.md %}
@@ -231,16 +228,14 @@ download a new file each time you want to upgrade Docker Engine.
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. The `docker` user
-group exists but contains no users, which is why you're required to use `sudo`
-to run Docker commands. Continue to [Linux post-install](linux-postinstall.md)
-to allow non-privileged users to run Docker commands and for other optional
-configuration steps.
+You have now successfully installed and started Docker Engine.
+
+{% include root-errors.md %}
#### Upgrade Docker Engine
-To upgrade Docker Engine, download the newer package file and repeat the
-[installation procedure](#install-from-a-package), pointing to the new file.
+To upgrade Docker Engine, download the newer package files and repeat the
+[installation procedure](#install-from-a-package), pointing to the new files.
{% include install-script.md %}
@@ -260,7 +255,7 @@ To upgrade Docker Engine, download the newer package file and repeat the
$ sudo rm -rf /var/lib/containerd
```
-You must delete any edited configuration files manually.
+You have to delete any edited configuration files manually.
## Next steps
diff --git a/engine/install/fedora.md b/engine/install/fedora.md
index 2ee95d6d02..d29c670cc8 100644
--- a/engine/install/fedora.md
+++ b/engine/install/fedora.md
@@ -11,14 +11,15 @@ toc_max: 4
---
To get started with Docker Engine on Fedora, make sure you
-[meet the prerequisites](#prerequisites), then
-[install Docker](#installation-methods).
+[meet the prerequisites](#prerequisites), and then follow the
+[installation steps](#installation-methods).
## Prerequisites
### 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
@@ -26,8 +27,9 @@ To install Docker Engine, you need the 64-bit version of one of these Fedora ver
### Uninstall old versions
-Older versions of Docker were called `docker` or `docker-engine`. If these are
-installed, uninstall them, along with associated dependencies.
+Older versions of Docker went by the names of `docker` or `docker-engine`.
+Uninstall any such older versions before attempting to install a new version,
+along with associated dependencies.
```console
$ sudo dnf remove docker \
@@ -42,33 +44,33 @@ $ sudo dnf remove docker \
docker-engine
```
-It's OK if `dnf` reports that none of these packages are installed.
+`dnf` might report that you have none of these packages installed.
-The contents of `/var/lib/docker/`, including images, containers, volumes, and
-networks, are preserved. The Docker Engine package is now called `docker-ce`.
+Images, containers, volumes, and networks stored in `/var/lib/docker/` aren't
+automatically removed when you uninstall Docker.
## Installation methods
You can install Docker Engine in different ways, depending on your needs:
-- Most users
+- 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.
-- Some users download the RPM package and
+- You can download the RPM package and
[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, some users choose to use automated
+- In testing and development environments, you can use automated
[convenience scripts](#install-using-the-convenience-script) to install Docker.
-### Install using the repository
+### 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 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.
#### Set up the repository
@@ -79,75 +81,87 @@ your DNF repositories) and set up the repository.
```console
$ sudo dnf -y install dnf-plugins-core
-
-$ sudo dnf config-manager \
- --add-repo \
- {{ download-url-base }}/docker-ce.repo
+$ 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 Docker Engine, containerd, and Docker Compose:
- ```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.
+ To install the latest version, run:
- 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.
+ ```console
+ $ sudo dnf install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
+ ```
-2. To install a _specific version_ of Docker Engine, list the available versions
- in the repo, then select and install:
+ 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.
- a. List and sort the versions available in your repo. This example sorts
- results by version number, highest to lowest, and is truncated:
+ 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.
- ```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
- <...>
- ```
+ To install a specific version, start by listing the available versions in
+ the repository:
- 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).
+ ```console
+ $ dnf list docker-ce --showduplicates | sort -r
- 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`.
+ 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
+ <...>
+ ```
- ```console
- $ sudo dnf -y install docker-ce- docker-ce-cli- containerd.io docker-buildx-plugin docker-compose-plugin
- ```
+ 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).
- 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.
+ 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`.
-3. Start Docker.
+ Replace `` with the desired version and then run the following
+ command to install:
- ```console
- $ sudo systemctl start docker
- ```
+ ```console
+ $ sudo dnf -y install docker-ce- docker-ce-cli- containerd.io docker-buildx-plugin docker-compose-plugin
+ ```
-4. Verify that Docker Engine is installed correctly by running the `hello-world`
- image.
+ 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.
- ```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.
+2. Start Docker.
-This installs and runs Docker Engine. Use `sudo` to run Docker
-commands. Continue to [Linux postinstall](linux-postinstall.md) to allow
-non-privileged users to run Docker commands and for other optional configuration
-steps.
+ ```console
+ $ sudo systemctl start docker
+ ```
+
+3. Verify that the Docker Engine installation is successful 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.
+
+You have now successfully installed and started Docker Engine.
+
+{% include root-errors.md %}
#### Upgrade Docker Engine
@@ -156,72 +170,72 @@ choosing the new version you want to install.
### Install from a package
-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.
+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.
-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 the Docker Engine installation is successful 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 confirmation message and exits.
-This installs and runs Docker Engine.
+You have now successfully installed and started Docker Engine.
{% include root-errors.md %}
#### Upgrade Docker Engine
-To upgrade Docker Engine, download the newer package file and repeat the
+To upgrade Docker Engine, download the newer package files and repeat the
[installation procedure](#install-from-a-package), using `dnf -y upgrade`
-instead of `dnf -y install`, and point to the new file.
+instead of `dnf -y install`, and point to the new files.
{% include install-script.md %}
## 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 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 must delete any edited configuration files manually.
+You have to delete any edited configuration files manually.
## Next steps
- Continue to [Post-installation steps for Linux](linux-postinstall.md).
-- Review the topics in [Develop with Docker](../../develop/index.md) to learn how to build new applications using Docker.
+- Review the topics in [Develop with Docker](../../develop/index.md) to learn
+ how to build new applications using Docker.
diff --git a/engine/install/rhel.md b/engine/install/rhel.md
index e20b2dcfcd..a4764b4d63 100644
--- a/engine/install/rhel.md
+++ b/engine/install/rhel.md
@@ -15,8 +15,8 @@ toc_max: 4
---
To get started with Docker Engine on RHEL, make sure you
-[meet the prerequisites](#prerequisites), then
-[install Docker](#installation-methods).
+[meet the prerequisites](#prerequisites), and then follow the
+[installation steps](#installation-methods).
## Prerequisites
@@ -28,16 +28,19 @@ 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:
-The `overlay2` storage driver is recommended.
+- RHEL 7 on s390x (IBM Z)
+- RHEL 8 on s390x (IBM Z)
+- RHEL 9 on s390x (IBM Z)
### Uninstall old versions
-Older versions of Docker were called `docker` or `docker-engine`. If these are
-installed, uninstall them, along with associated dependencies. Also uninstall
-`Podman` and the associated dependencies if installed already.
+Older versions of Docker went by the names of `docker` or `docker-engine`.
+Uninstall any such older versions before attempting to install a new version,
+along with associated dependencies. Also uninstall `Podman` and the associated
+dependencies if installed already:
```console
$ sudo yum remove docker \
@@ -52,33 +55,33 @@ $ sudo yum remove docker \
runc
```
-It's OK if `yum` reports that none of these packages are installed.
+`yum` might report that you have none of these packages installed.
-The contents of `/var/lib/docker/`, including images, containers, volumes, and
-networks, are preserved. The Docker Engine package is now called `docker-ce`.
+Images, containers, volumes, and networks stored in `/var/lib/docker/` aren't
+automatically removed when you uninstall Docker.
## Installation methods
You can install Docker Engine in different ways, depending on your needs:
-- Most users
+- 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.
-- Some users download the RPM package and
+- You can download the RPM package and
[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, some users choose to use automated
+- In testing and development environments, you can use automated
[convenience scripts](#install-using-the-convenience-script) to install Docker.
-### Install using the repository
+### 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 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.
#### Set up the repository
@@ -89,72 +92,85 @@ utility) and set up the repository.
```console
$ sudo yum install -y yum-utils
-
-$ sudo yum-config-manager \
- --add-repo \
- {{ download-url-base }}/docker-ce.repo
+$ 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 Docker Engine, containerd, and Docker Compose:
- ```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.
+ To install the latest version, run:
- 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.
+ ```console
+ $ sudo yum install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
+ ```
-2. To install a _specific version_ of Docker Engine, list the available versions
- in the repo, then select and install:
+ 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.
- a. List and sort the versions available in your repo. This example sorts
- results by version number, highest to lowest, and is truncated:
+ 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.
- ```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
- <...>
- ```
+ To install a specific version, start by listing the available versions in
+ the repository:
- 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).
+ ```console
+ $ yum list docker-ce --showduplicates | sort -r
- 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`.
+ docker-ce.s390x 3:23.0.5-1.el8 docker-ce-stable
+ docker-ce.s390x 3:23.0.4-1.el8 docker-ce-stable
+ <...>
+ ```
- ```console
- $ sudo yum install docker-ce- docker-ce-cli- containerd.io docker-buildx-plugin docker-compose-plugin
- ```
+ 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).
- 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.
+ 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`.
-3. Start Docker.
+ Replace `` with the desired version and then run the following
+ command to install:
- ```console
- $ sudo systemctl start docker
- ```
+ ```console
+ $ sudo yum install docker-ce- docker-ce-cli- containerd.io docker-buildx-plugin docker-compose-plugin
+ ```
-4. Verify that Docker Engine is installed correctly by running the `hello-world`
- image.
+ 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.
- ```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.
+2. Start Docker.
-This installs and runs Docker Engine.
+ ```console
+ $ sudo systemctl start docker
+ ```
+
+3. Verify that the Docker Engine installation is successful 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.
+
+You have now successfully installed and started Docker Engine.
{% include root-errors.md %}
@@ -165,73 +181,72 @@ choosing the new version you want to install.
### Install from a package
-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.
+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.
-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 the Docker Engine installation is successful 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 confirmation message and exits.
-This installs and runs Docker Engine. Use `sudo` to run Docker commands.
-Continue to [Post-installation steps for Linux](linux-postinstall.md) to allow
-non-privileged users to run Docker commands and for other optional configuration
-steps.
+You have now successfully installed and started Docker Engine.
+
+{% include root-errors.md %}
#### Upgrade Docker Engine
-To upgrade Docker Engine, download the newer package file and repeat the
+To upgrade Docker Engine, download the newer package files and repeat the
[installation procedure](#install-from-a-package), using `yum -y upgrade`
-instead of `yum -y install`, and point to the new file.
+instead of `yum -y install`, and point to the new files.
{% include install-script.md %}
## 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 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 must delete any edited configuration files manually.
+You have to delete any edited configuration files manually.
## Next steps
- Continue to [Post-installation steps for Linux](linux-postinstall.md).
-- Review the topics in [Develop with Docker](../../develop/index.md) to learn how to build new applications using Docker.
+- Review the topics in [Develop with Docker](../../develop/index.md) to learn
+ how to build new applications using Docker.
diff --git a/engine/install/sles.md b/engine/install/sles.md
index 357eb2af75..eb58ed25f6 100644
--- a/engine/install/sles.md
+++ b/engine/install/sles.md
@@ -22,8 +22,8 @@ toc_max: 4
---
To get started with Docker Engine on SLES, make sure you
-[meet the prerequisites](#prerequisites), then
-[install Docker](#installation-methods).
+[meet the prerequisites](#prerequisites), and then follow the
+[installation steps](#installation-methods).
## Prerequisites
@@ -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.
@@ -58,12 +61,11 @@ $ opensuse_repo="https://download.opensuse.org/repositories/security:SELinux/15.
$ sudo zypper addrepo $opensuse_repo
```
-The `overlay2` storage driver is recommended.
-
### Uninstall old versions
-Older versions of Docker were called `docker` or `docker-engine`. If these are
-installed, uninstall them, along with associated dependencies.
+Older versions of Docker went by the names of `docker` or `docker-engine`.
+Uninstall any such older versions before attempting to install a new version,
+along with associated dependencies.
```console
$ sudo zypper remove docker \
@@ -77,33 +79,33 @@ $ sudo zypper remove docker \
runc
```
-It's OK if `zypper` reports that none of these packages are installed.
+`zypper` might report that you have none of these packages installed.
-The contents of `/var/lib/docker/`, including images, containers, volumes, and
-networks, are preserved. The Docker Engine package is now called `docker-ce`.
+Images, containers, volumes, and networks stored in `/var/lib/docker/` aren't
+automatically removed when you uninstall Docker.
## Installation methods
You can install Docker Engine in different ways, depending on your needs:
-- Most users
+- 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.
-- Some users download the RPM package and
+- You can download the RPM package and
[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, some users choose to use automated
+- In testing and development environments, you can use automated
[convenience scripts](#install-using-the-convenience-script) to install Docker.
-### Install using the repository
+### 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 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.
#### Set up the repository
@@ -117,63 +119,79 @@ $ 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 Docker Engine, containerd, and Docker Compose:
- ```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.
+ To install the latest version, run:
- 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.
+ ```console
+ $ sudo zypper install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
+ ```
-2. To install a _specific version_ of Docker Engine, list the available versions
- in the repo, then select and install:
+ 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.
- a. List and sort the versions available in your repo. This example sorts
- results by version number, highest to lowest, and is truncated:
+ 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.
- ```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.
+ To install a specific version, start by listing the available versions in
+ the repository:
- 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 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 install docker-ce- docker-ce-cli- containerd.io docker-buildx-plugin docker-compose-plugin
- ```
+ The list returned depends on which repositories are enabled, and is specific
+ to your version of SLES.
- 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.
+ 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`.
-3. Start Docker.
+ Replace `` with the desired version and then run the following
+ command to install:
- ```console
- $ sudo systemctl start docker
- ```
+ ```console
+ $ sudo zypper install docker-ce- docker-ce-cli- containerd.io docker-buildx-plugin docker-compose-plugin
+ ```
-4. Verify that Docker Engine is installed correctly by running the `hello-world`
- image.
+ 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.
- ```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.
+2. Start Docker.
-This installs and runs Docker Engine.
+ ```console
+ $ sudo systemctl start docker
+ ```
+
+3. Verify that the Docker Engine installation is successful 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.
+
+You have now successfully installed and started Docker Engine.
{% include root-errors.md %}
@@ -184,73 +202,72 @@ choosing the new version you want to install.
### Install from a package
-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.
+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.
-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 `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 the Docker Engine installation is successful 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 confirmation message and exits.
-This installs and runs Docker Engine. Use `sudo` to run Docker commands.
-Continue to [Post-installation steps for Linux](linux-postinstall.md) to allow
-non-privileged users to run Docker commands and for other optional configuration
-steps.
+You have now successfully installed and started Docker Engine.
+
+{% include root-errors.md %}
#### Upgrade Docker Engine
-To upgrade Docker Engine, download the newer package file and repeat the
+To upgrade Docker Engine, download the newer package files and repeat the
[installation procedure](#install-from-a-package), using `zypper -y upgrade`
-instead of `zypper -y install`, and point to the new file.
+instead of `zypper -y install`, and point to the new files.
{% include install-script.md %}
## 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 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 must delete any edited configuration files manually.
+You have to delete any edited configuration files manually.
## Next steps
- Continue to [Post-installation steps for Linux](linux-postinstall.md).
-- Review the topics in [Develop with Docker](../../develop/index.md) to learn how to build new applications using Docker.
+- Review the topics in [Develop with Docker](../../develop/index.md) to learn
+ how to build new applications using Docker.
diff --git a/engine/install/ubuntu.md b/engine/install/ubuntu.md
index afe1d44503..cfde5054f8 100644
--- a/engine/install/ubuntu.md
+++ b/engine/install/ubuntu.md
@@ -85,11 +85,7 @@ Docker from the repository.
```console
$ sudo apt-get update
-
- $ sudo apt-get install \
- ca-certificates \
- curl \
- gnupg
+ $ sudo apt-get install ca-certificates curl gnupg
```
2. Add Docker's official GPG key:
@@ -160,7 +156,7 @@ Docker from the repository.