Install Mirantis Container Runtime for Rocky Linux¶

You can install Mirantis Container Runtime (MCR) either through the use of a repository, or by downloading and installing RPM packages.

Install and upgrade MCR from a repository¶

Mirantis recommends that you install MCR from our Docker repository using DNF, a tool for RPM-based distributions that works with your repositories to manage dependencies and provide automatic updates.

Note

It is not necessary to uninstall older versions of Docker or Mirantis Container Runtime prior to upgrading as package conflicts are resolved automatically by DNF.

Set up the repository¶

You only need to set the repository up once. After doing so, you can install MCR from the repo and repeatedly upgrade the software as necessary.

Create or modify the /etc/yum.repos.d/docker-ee.repo file to contain the following:

[mirantis]
name=Mirantis Container Runtime
baseurl=https://repos.mirantis.com/rocky/$releasever/$basearch/<update-channel>
enabled=1
gpgcheck=1
gpgkey=https://repos.mirantis.com/rocky/gpg
module_hotfixes=true

(Optional) To install a specific version of Mirantis Container Runtime 25.0, which Mirantis recommends for production systems, edit <update-channel> in the baseurl parameter of the /etc/yum.repos.d/docker-ee.repo file to the version you want to pin.

Example, for the MCR 25.0.7 non-FIPS version:
```
baseurl=https://repos.mirantis.com/rocky/$releasever/$basearch/stable-25.0.7
```
Example, for the MCR 25.0.7 FIPS version:
```
baseurl=https://repos.mirantis.com/rocky/$releasever/$basearch/stable-25.0.7/fips
```
Note

To ascertain which 25.0.x versions are available for pinning:
1. In your browser, go to https://repos.mirantis.com.
2. Navigate to directory for your Linux OS, and within that directory navigate to the sub-directory for your OS architecture. For example, for an Rocky Linux 9 system on an x86_64 architecture you will go to https://repos.mirantis.com/rocky/9/x86_64/.

Note

$releasever and $basearch are repo variables that must be placed into the /etc/yum.repos.d/docker-ee.repo file exactly as written.
The final baseurl path segment is the update channel, which determines which MCR releases will be available for installation and upgrade. The value for the latest MCR 25.0.x patch is stable-25.0 and the value for the latest MCR 25.0.x patch with the FIPS-mode variant is stable-25.0/fips.

Install from the repository¶

Run the following command to install MCR from the repository:

sudo dnf install docker-ee

If you are prompted to accept the GPG key, first verify that the key has the fingerprint 77FE DA13 1A83 1D29 A418 D3E8 99E5 FF2E 7668 2BC9.

Upgrade from the repository¶

Run dnf upgrade to keep your MCR installation up to date with the latest MCR release that is available in the update channel you selected during the repository setup.

Install and upgrade MCR from a package¶

If for some reason you cannot use the repository MCR install method, you can perform manual installation with the .rpm package files for your release. Be aware, though, that you will need to download new packages each time you want to upgrade MCR.

Install with a package¶

Download the packages for your Rocky Linux distribution, the links for which are available in the MCR release notes.

Install MCR.

sudo dnf install path/to/downloaded/packages/*.rpm

Upgrade from a package¶

Download the newer .rpm packages for your Rocky Linux version.

Upgrade MCR.

sudo dnf install path/to/downloaded/packages/*.rpm

Initial setup¶

The Docker service is not started automatically at MCR installation. The docker group is created, but without any users added to the group.

Configure Docker to start at boot up and start Docker.
```
sudo systemctl enable --now docker.service
```
Run the hello-world image to verify that MCR is correctly installed. This command downloads a test image, runs it in a container, prints an informational message, and exits:
```
sudo docker run hello-world
```

Important

Use sudo to run docker commands. For information on how to allow non-privileged users to run docker commands, refer to the official Docker documentation Manage Docker as a non-root user.

Uninstall Mirantis Container Runtime¶

Uninstall the Mirantis Container Runtime package:
```
sudo dnf remove docker-ee
```
Delete all images, containers, and volumes, as these are not automatically removed from your host:
```
sudo rm -rf /var/lib/docker
```

Delete all other Docker-related resources:

sudo rm -rf /run/docker /var/run/docker /etc/docker

Manually delete any edited configuration files.