Kublr Release 1.21.2 (2021-08-10)

Kublr Quick Start

sudo docker run --name kublr -d --restart=unless-stopped -p 9080:9080 kublr/kublr:1.21.2

Follow the full instructions in Quick start for Kublr Demo/Installer.

The Kublr Demo/Installer is a lightweight, dockerized, limited-functionality Kublr Platform which can be used to:

  • Test setup and management of a standalone Kubernetes cluster
  • Setup a full-featured Kublr Platform

The Kublr Demo/Installer stores all of the data about the created clusters inside the Docker container. If you delete the Docker container you will lose all data about the created clusters and the Kublr platforms. However, you will not lose the clusters and the platforms themselves.

We recommend using the Kublr Demo/Installer to verify if a Kubernetes cluster can be created in your environment and to experiment with it. To manage a real cluster and experience all features, you can create a full-featured Kublr Platform in a cloud or on-premise.


The Kublr 1.21.2 patch release contains bug fixes in vCloud Director and vSphere providers, as well as a fix for a critical Tiller issue that prevented clusters creation and updates.

Additionally, full support of Kuberntes v1.21.3 is added.

Important Fixes and Improvements

  • A critical Tiller issue is fixed.

    In the Kublr Agents default Tiller docker image is changed to docker.io/helmpack/tiller.

    In the Kublr Control Plane Tiller is now not required for cluster create and/or update operations to complete.

    Migration to the latest Kublr Agents and Kublr Control Plane 1.21.2 or later is recommended.

    Please refer to the troubleshooting guide for other solutions.

  • Kubernetes v1.21.3 is used by default

  • Fixed issue with Master node label pod terminating in some situations

  • vSphere:

    • improved support for Storage DRS cluster
    • VM Template names should be shorter than 80 characters
  • Logging: Kibana Spaces and scaling support

  • Elasticsearch exporter migrated to https://github.com/prometheus-community/elasticsearch_exporter

  • Monitoring

    • Grafana default user roles support
    • Support for defining additional Prometheus rules via ConfigMap
  • Kublr operator: support configurable Helm timeout

  • UI improvements

AirGap Artifacts list

Additionally, you need to download the BASH scripts from https://repo.kublr.com

You also need to download Helm package archives and Docker images:

Supported Kubernetes versions




v1.18 (Deprecated in 1.22.0)

v1.17 (Deprecated in 1.21.0, End of support in 1.22.0)

Components versions


ComponentVersionKublr AgentNotes
Kubernetes1.211.21.3-10default v1.21.3 in 1.22.0 of support in 1.22.0

Kublr Control Plane

Kublr Control Plane1.21.2-52
Kublr Operator1.21.2-32

Kublr Platform Features

Kublr System1.21.2-30
LocalPath Provisioner (helm chart version)0.0.12-8
nginx ingress controller (helm chart version)1.36.2
Centralized Logging1.21.2-37
SearchGuard Kibana plugin49.0.0
SearchGuard Admin7.10.2-49.0.0
Centralized Monitoring1.21.2-28
Kube State Metrics2.4.1
Victoria Metrics
Kublr KubeDB (Deprecated in 1.22.0, End of support in 1.23.0)1.21.2-25
kubedb (helm chart version)v0.14.0-alpha.2

Known issues and limitations

  1. Due to docker image gcr.io/kubernetes-helm/tiller:v2.14.3 discontinued in Google Image repository in August 2021, ( related issue: “Make Tiller Image Available on Docker Hub” ), cluster create and update operations may fail to complete with older Kublr agents.

    The cluster hangs in “Creating” or “Updating” state indefinitely or for a very long time, or goes to “Error” state, in all cases with Tiller pod unhealthy due to Tiller image not available.

    All versions of Kublr before 1.21.2 (current version), and Kublr Agent versions earlier than the ones included in Kublr 1.21.2 are affected.

    The issue and available solutions are described in the troubleshooting guide on Kublr support portal.

    Migration to the latest Kublr Agents and Kublr Control Plane versions or t least Kublr 1.21.2 is recommended.

  2. In the previous Kublr Agent and Control Plane versions cluster goes to Error state with Tiller image not available ( related issue: Make Tiller Image Available on Docker Hub )

    The issue and available solutions are described in the troubleshooting guide on Kublr support portal.

    Migration to the latest Kublr Agents and Kublr Control Plane versions is recommended.

  3. Canal CNI (default) does not work on AWS images with nm-cloud-config. At the moment it only affects RHEL 8 image.

    As a workaround, remove or disable nm-cloud-config or use a different CNI plugin (e.g. CNI Calico).

  4. SELinux is not supported for ContainerD CRI

  5. Containerd CRI is only supported for Kublr Agents 1.19, 1.20, and 1.21

  6. vCloud Director implementation does not support named disks for persistent volumes by default. vCloud Director CSI driver needs to be installed in the cluster.

  7. Beginning November 2, 2020, progressive enforcement of rate limits for anonymous and authenticated Docker Hub usage came into effect. Learn more about the change from the article Understanding Docker Hub Rate Limiting. Kublr clusters use some images hosted on Docker Hub / docker.io (e.g. kubernetesui/dashboard:v2.0.4). As a result some cluster operations may fail due to Docker Hub rate limiting. You can avoid possible issues using one of the following solutions:

    1. If you have a paid Docker Hub account, create a docker.io secret in Kublr Control Plane and add this docker registry to the cluster specification using advanced section in Kublr cluster creation UI.
    2. Override docker.io registry with cr.kublr.com, all imagess needed for cluster installation are mirrored in this repo. Learn more about docker registry override in the Kublr documentation cluster specification reference.