How to Install Docker CE on CentOS 8 / RHEL 8

Docker is a daemon-based container engine which allows us to deploy applications inside containers. With the release of RHEL 8 and CentOS 8, docker package has been removed from their default package repositories, docker has been replaced with podman and buildah.


If are comfortable with docker and deploy most the applications inside the docker containers and does not want to switch to podman then this tutorial will guide you on how to install and use community version of docker on CentOS 8 and RHEL 8 system.

Docker is available in two versions,

  • Docker CE (Community Edition)
  • Enterprise Edition (EE)

In this guide we will learn how to install Docker CE (Community Edition) on CentOS 8 or RHEL 8 Server.

System Requirements for Docker CE

  • Minimal CentOS 8 / RHEL 8
  • Sudo or root privileges
  • Internet Connection

Installation Steps of Docker CE on CentOS 8/RHEL 8 Server

Step:1) Enable Docker CE Repository

As we said above, docker packages are not available anymore on CentOS 8 or RHEL 8 package repositories, so run following dnf command to enable Docker CE package repository.

[[email protected] ~]# dnf config-manager --add-repo=

Step:2) Install Docker CE using dnf command

Once the docker ce repo has been configured successfully then run following command to verify which version of docker is available for installation

[[email protected] ~]# dnf list docker-ce
Available Packages
docker-ce.x86_64              3:19.03.5-3.el7                    docker-ce-stable
[[email protected] ~]#

Now, use beneath dnf command to install latest version of docker,

[[email protected] ~]# dnf install docker-ce --nobest -y

After the installation of docker, start and enable its service using the following systemctl commands

[[email protected] ~]# systemctl start docker
[[email protected] ~]# systemctl enable docker

Run the following command to verify installed docker version

[[email protected] ~]# docker --version
Docker version 18.06.3-ce, build d7080c1
[[email protected] ~]#

Step:3) Verify and test Docker CE Engine

To verify whether docker ce engine has been setup correctly or not, try to spin up a “hello-world” container using below docker command,

[[email protected] ~]# docker run hello-world

Output of above command


As we can see the informational message in above output which confirms docker engine is setup correctly on CentOS 8 / RHEL 8 Server. Let’s move to docker compose installation.

Step:4) Install Docker Compose

As we know that docker compose is used to link multiple containers using a single command. In other words, Docker Compose is useful where we need to launch multiple containers and these containers depends on each other. Examples like launching LAMP/ LEMP applications (WordPress & Joomla etc) insider containers.

Run the following commands to install docker compose on CentOS 8 / RHEL 8,

[[email protected] ~]# dnf install curl -y
[[email protected] ~]# curl -L "$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

Note: Replace “1.25.0” with docker compose version that you want to install but at this point of time this is the latest and stable version of docker compose.

Set the executable permission to docker-compose binary

[[email protected] ~]# chmod +x /usr/local/bin/docker-compose

Verify the docker compose version by running the following command.

[[email protected] ~]# docker-compose --version
docker-compose version 1.25.0, build 0a186604
[[email protected] ~]#

That’s all from this tutorial, I hope these steps help you to setup docker and docker compose on CentOS 8 and RHEL 8 server. Kindly share your feedback and comments in the comments section below.

Read Also : How to Run Containers with Podman on CentOS 8 / RHEL 8

Read Also: How to Use docker-compose to launch containers

16 Responses

  1. Gunnar Thielebein says:

    This guide is incorrect for Centos8.
    The official docker repositories only ship Centos-7 packages for docker-ce.

    Installing docker-ce within Centos-8 fails with an error message:

    sudo -E dnf install docker-ce
    Last metadata expiration check: 0:02:14 ago on Wed 29 Jan 2020 06:13:57 AM EST.
    Problem: package docker-ce-3:19.03.5-3.el7.x86_64 requires >= 1.2.2-3, but none of the providers can be installed
    – cannot install the best candidate for the job
    – package is excluded
    – package is excluded
    – package is excluded
    – package is excluded
    – package is excluded
    – package is excluded
    (try to add ‘–skip-broken’ to skip uninstallable packages or ‘–nobest’ to use not only best candidate packages)

  2. Pradeep Kumar says:

    Hi Gunnar,

    After configuring the Docker CE repository , run the following to install docker-ce package

    # dnf install docker-ce –nobest -y

  3. Marcos Riso says:

    Hi Pradeep, I discovered what was the Gunnar’s problem, first you must remove podman from the system with
    sudo yum remove podman
    Then it will work fine!


  4. Vaidya Bala says:


    Great How-to. Big fan of the site. However, following these steps as root means, we need to do sudo everytime we want to run docker. It is best to add the normal user to the docker group. May be adding those steps to this howto will make it complete.

    Here is what i am referring to:

  5. ClancyDamon says:

    Thank you Marcos! That was my problem. The instructions in this article worked like a charm after removing podman.

  6. Gunnar Thielebein says:

    Update from my site. I get docker installation suceeded in centos8 after removing podman, like it was suggested.
    Thanks anyone for the tips.

    To get docker compose (e.g. awx) running with external access to the website it was neccessary to enable NAT on the firewall level. This was suggested from Michael Kofler in his german Blog [1].

    firewall-cmd –zone=public –add-masquerade –permanent
    firewall-cmd –reload


  7. Fernando says:

    Very usefull

  8. Omidiji Rasheed says:

    Thanks, man…
    Very useful information

  9. saisu says:

    When trying to run `sudo docker run hello-world` the system returns:
    docker: Error response from daemon: OCI runtime create failed: container_linux.go:349: starting container process caused “process_linux.go:449: container init caused \”write /proc/self/attr/keycreate: permission denied\””: unknown.
    ERRO[0000] error waiting for container: context canceled
    What went wrong here?

  10. Vardhaman Kothari says:

    After installing Docker compose if it shows bash: docker-compose: command not found…
    You need to create a symbolic link /usr/bin or any other directory in your path.
    Try this:
    sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose

    And then it works

  11. Rob says:

    @Pradeep Kumar containerd update from external repos is blocked by CentOS8. Workaround for now seems to be to install the CentOS7 version. If you don’t install it, you get the error you mentioned every time you try dnf update. –nobest is the enemy here.

    rpm -Uvh

  12. Dan Thompson says:

    very useful and detailed – thank you 🙂

  13. n jaywant says:

    I am getting below error for RHEL 8.2:
    Docker version 19.03.9, build 9d988398e7
    [[email protected] ~]# docker version
    Client: Docker Engine – Community
    Version: 19.03.9
    API version: 1.40
    Go version: go1.13.10
    Git commit: 9d988398e7
    Built: Fri May 15 00:25:27 2020
    OS/Arch: linux/amd64
    Experimental: false
    Error response from daemon: client version 1.40 is too new. Maximum supported API version is 1.39
    [[email protected] ~]#

  14. kklepper says:

    @n jaywan

    upgrade to latest

    curl -L “$(uname -s)-$(uname -m)” -o /usr/local/bin/docker-compose
    chmod +x /usr/local/bin/docker-compose
    docker-compose –version

  15. Solutions Architect says:

    Hi Pradeep,

    I found you blog very useful, I was setting up docker on my RED HAT Enterprise edition and this blog simplified installation process.

    Thanks for posting it.


  16. neingeist says:

    If you disable CentOS’ container-tools module you can install the latest Docker CE using docker-ce.repo, that is no more –nobest necessary:

    dnf module disable container-tools
    dnf install docker-ce docker-ce-selinux

Leave a Reply

Your email address will not be published. Required fields are marked *

Pin It on Pinterest