Containerd Add-On

Containerd is the recommended CRI (Container Runtime Interface). If docker was previously installed and containerd is enabled in the yaml spec, then the cluster will be migrated to containerd and docker will be uninstalled.

As CentOS, RHEL and Oracle Linux 8.x do not support Docker, the Containerd CRI is required.

Containerd 1.4.8+ has dropped support for Ubuntu 16.04.

About Containerd upgrades

If you are planning to upgrade your Containerd installation, it is highly recommended that you refer to the relevant documentation page for guidance and best practices.

Host Package Requirements

The following host packages are required for Red Hat Enterprise Linux 9 and Rocky Linux 9:

  • bash
  • libseccomp
  • libzstd
  • systemd
  • container-selinux

The following host packages are required for Amazon Linux 2023 and Ubuntu 24.04:

  • bash
  • libseccomp2
  • libzstd1
  • systemd
  • container-selinux
  • containerd

The containerd package does not need to match the version of the containerd add-on.

Maximum Containerd Versions

Not every version of Containerd is available for every OS. If your kURL spec requests a newer version of Containerd than can be installed for your current operating system, the latest version will be installed instead.

Operating System Latest Version
RHEL 7 1.6.33
CentOS 7 1.6.33
Oracle Linux 7 1.6.33
Ubuntu 18.04 1.6.21

For instance, if you attempt to install Containerd 1.7.25 on a RHEL 7 system, kURL will instead install Containerd 1.6.33.

Advanced Install Options

spec:
  containerd:
    version: 1.7.x
    preserveConfig: false
    tomlConfig: |
      [debug]
        "level" = "info"

Flag Usage
version The version of containerd to be installed
tomlConfig Containerd config settings that will be merged into /etc/containerd/config.toml
preserveConfig This flag will ensure that nothing is changed in the existing containerd config on the system, regardless of other options.