Docker is an open source containerization platform. It enables developers to package applications into containers—standardized executable components combining application source code with the operating system (OS) libraries and dependencies required to run that code in any environment.
Docker is a set of platform as a service products that use OS-level virtualization to deliver software in packages called containers. Containers are isolated from one another and bundle their own software, libraries and configuration files; they can communicate with each other through well-defined channels.
In this guide we are going to explore various options to install docker in Rocky Linux/Centos 8
Related content
- How to install and configure docker in Rocky Linux/Alma Linux 9
- How to install and configure docker In OpenSUSE Leap 15
- How to install and configure docker In SUSE Linux Enterprise
- How to install and configure docker In Fedora 34/35
- How to Install and Use Docker in Ubuntu 20.04
- How to install and configure docker on Debian 11
- Getting Started With Docker Compose With Examples
- Docker as a build agent – Run Jenkins builds on Docker
Prerequisites
To install Docker Engine, you need to have the following
- Updated Rocky Linux/Centos/RHEL 8 based server
- Internet connection
- Basic knowledge of linux terminal
- The
centos-extras
repository must be enabled. It should be enabled by default
Table of Content
- Update system packages
- Uninstall old versions
- Installing docker
- Starting and enabling Docker
- Uninstalling Docker
Updating system packages
Before proceeding let’s ensure that our system is up to date. Use this command to update the system and all the packages
$ sudo dnf -y update
Last metadata expiration check: 2:18:21 ago on Thu 14 Oct 2021 05:52:52 PM UTC.
Dependencies resolved.
Nothing to do.
Complete!
Uninstall old versions
If older versions of docker are installed in the system, uninstall them, along with associated dependencies.
sudo <meta charset="utf-8">dnf remove docker \
docker-client \
docker-client-latest \
docker-common \
docker-latest \
docker-latest-logrotate \
docker-logrotate \
docker-engine
Installing docker
There are multiple ways of installing docker in Centos 8. You can:
- Set up docker repositories. This is recommended as you can even upgrade docker once set up
- Download rpm and install manually
- You can choose an automated convenience scripts to install Docker
Install using the repository
The docker packages are not found in the default Centos 8 repositories. You need to set up the Docker repository when installing docker in a new system.
Install the yum-utils
package (which provides the yum-config-manager
utility) and set up the stable repository.
sudo <meta charset="utf-8">yum install -y yum-utils
sudo yum-config-manager \
--add-repo \
https://download.docker.com/linux/centos/docker-ce.repo
To install the latest version of Docker Engine and containerd:
sudo dnf install docker-ce docker-ce-cli containerd.io -y
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, 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:
$ sudo dnf list docker-ce --showduplicates | sort -r
Installed Packages
docker-ce.x86_64 3:20.10.9-3.el8 docker-ce-stable
docker-ce.x86_64 3:20.10.9-3.el8 @docker-ce-stable
docker-ce.x86_64 3:20.10.8-3.el8 docker-ce-stable
docker-ce.x86_64 3:20.10.7-3.el8 docker-ce-stable
Available Packages
The above command will list packages based on which repositories are enabled.
Install a specific version by its fully qualified package name, which is the package name (docker-ce
) plus the version string (2nd column) starting at the first colon (:
), up to the first hyphen, separated by a hyphen (-
). For example3:20.10.7
.
sudo dnf install docker-ce-<VERSION_STRING> docker-ce-cli-<VERSION_STRING> containerd.io
Install using a package
If for any reason you can not use docker’s repository for the installation, you can download an rpm package and install manually.
Go to https://download.docker.com/linux/centos/ 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
Install Docker Engine, changing the path below to the path where you downloaded the Docker package.
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.
Install using the convenience script
Docker provides a convenience script at get.docker.com to install Docker into development environments quickly and non-interactively. The convenience script is not recommended for production environments, but can be used as an example to create a provisioning script that is tailored to your needs.
The script requires root
or sudo
privileges to run. The script attempts to detect your Linux distribution and version and configure your package management system for you, and does not allow you to customize most installation parameters. The script installs dependencies and recommendations without asking for confirmation. By default, the script installs the latest stable release of Docker, containerd, and runc.
You can run the script with the DRY_RUN=1
option to learn what steps the script will execute during installation:
$ curl -fsSL https://get.docker.com -o get-docker.sh
$ DRY_RUN=1 sh ./get-docker.sh
This downloads the script from get.docker.com and runs it to install the latest stable release of Docker on Linux:
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
Starting and enabling docker
On RPM
based distributions, such as CentOS, Fedora, RHEL or SLES, you need to start it manually using the appropriate systemctl or service command. Non-root users cannot run Docker commands by default.
Use this command to start docker
sudo systemctl start docker
Confirm that docker is running by issuing the status command
$ sudo systemctl status docker
● docker.service - Docker Application Container Engine
Loaded: loaded (/usr/lib/systemd/system/docker.service; disabled; vendor preset: disabled)
Active: active (running) since Fri 2021-10-15 03:58:33 UTC; 20s ago
Docs: https://docs.docker.com
Main PID: 1462739 (dockerd)
Tasks: 8
Memory: 127.2M
CGroup: /system.slice/docker.service
└─1462739 /usr/bin/dockerd -H fd:// --containerd=/run/containerd/containerd.sock
Oct 15 03:58:33 test-db-server dockerd[1462739]: time="2021-10-15T03:58:33.127140137Z" level=error m>
Oct 15 03:58:33 test-db-server dockerd[1462739]: time="2021-10-15T03:58:33.152784201Z" level=warning>
To enable docker on boot, use this command:
sudo systemctl enable docker
Docker will not work for no-root users or without sudo, you will get the error below if you attempt.
$ docker ps
Got permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock: Get "http://%2Fvar%2Frun%2Fdocker.sock/v1.24/containers/json": dial unix /var/run/docker.sock: connect: permission denied
To use docker without Sudo, add the current user to the docker group then re-login.
Add the user to the docker group:
$ sudo usermod -aG docker ${USER}
Then relogin as the user
$ sudo su - ${USER}
Then check that you are now part of docker
$ id
uid=1000(centos) gid=1000(centos) groups=1000(centos),4(adm),190(systemd-journal),985(docker) context=unconfined_u:unconfined_r:unconfined_t:s0-s0:c0.c1023
Now we can confirm that everything is working by issuing the docker run
command for the hello-world
image:
$ docker run hello-world
Unable to find image 'hello-world:latest' locally
latest: Pulling from library/hello-world
2db29710123e: Pull complete
Digest: sha256:37a0b92b08d4919615c3ee023f7ddb068d12b8387475d64c622ac30f45c29c51
Status: Downloaded newer image for hello-world:latest
Hello from Docker!
This message shows that your installation appears to be working correctly.
Uninstalling Docker
If you no longer need docker in the system, use these commands to uninstall it
sudo dnf remove docker-ce docker-ce-cli containerd.io
- Images, containers, volumes, or customized configuration files on your host are not automatically removed. To delete all images, containers, and volumes:
sudo rm -rf /var/lib/docker
sudo rm -rf /var/lib/containerd<meta charset="utf-8">
You must delete any edited configuration files manually.
Conclusion
We have managed to install docker on a centos system either using the repository or downloading an rpm then installing it or using a convenience script.