Prepare Linux Operating System (CentOS) for a Docker Setup

Prior to installing the Aternity Docker Components Server you need to prepare a Linux server that comply with Aternity minimum requirements (learn more).

Operating system for Aternity Docker Components Server is as follows:
  • Linux CentOS 7.4 or 7.5 or 7.6 or 7.7 or 7.8 or 7.9. To verify your version of CentOS, enter cat /etc/centos-release

  • Red Hat Enterprise Linux (RHEL) 7.4 or 7.5 or 7.6 or 7.7 or 7.8 or 7.9. To verify the RHEL version, enter cat /etc/redhat-release

RHEL comes with the preinstalled Docker engine. But if you use CentOS, install the Docker engine for CentOS (learn more). If you do not have an internet access, follow the procedure below. You can always go to the Docker website to learn more.


  1. Step 1 Uninstall old Docker versions.

    Older versions of Docker were called docker or docker-engine. If these are installed, uninstall them, along with all associated dependencies.

    To uninstall, use the command:
    $ sudo yum remove docker \
                      docker-client \
                      docker-client-latest \
                      docker-common \
                      docker-latest \
                      docker-latest-logrotate \
                      docker-logrotate \
                      docker-selinux \
                      docker-engine-selinux \
  2. Step 2 Set up Docker's repositories and install from them.

    The Docker CE package is now called docker-ce.

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

    1. Install the required packages. yum-utils provides the yum-config-manager utility, whereas device-mapper-persistent-data and lvm2are are required by the devicemapper storage driver.
      $ sudo yum install -y yum-utils \
              device-mapper-persistent-data \
    2. Use the following command to set up the stable repository. You always need the stable repository, even if you want to install builds from the edge or test repositories as well.
      $ sudo yum-config-manager \
              --add-repo \
    3. (Optional): Enable the edge and test repositories. These repositories are included in the docker.repo file above, but they are disabled by default. You can enable them alongside the stable repository.
      $ sudo yum-config-manager --enable docker-ce-edge
      $ sudo yum-config-manager --enable docker-ce-test

      You can disable the edge or test repository by running the yum-config-manager command with the --disable flag. To re-enable it, use the --enable flag.

      The following command disables the edge repository:

      $ sudo yum-config-manager --disable docker-ce-edge

      Starting with Docker 17.06, stable releases are also pushed to the edge and test repositories.

  3. Step 3 Install the Docker CE using the repository.
    Install the latest version of the Docker CE by using the command:
    $ sudo yum install docker-ce

    Learn more about Docker installation.