Skip to content

Installation#

This section assumes that you already have a kubernetes cluster installed. If you need to setup a cluster you can follow the Create and prepare a Kubernetes cluster with k0s to create a test cluster, or Create and prepare a production grade Kubernetes cluster with EKS to create something more substantial.

The actual management cluster is a Kubernetes cluster with the Mirantis k0rdent Enterprise application installed. The simplest way to install Mirantis k0rdent Enterprise is through its Helm chart. You can find the latest release here, and from there you can deploy the Helm chart, as in:

Note

Don't forget to verify the installation files.

Configure the UI#

By default, Mirantis k0rdent Enterprise installs and enables the UI with a pre-determined password. Please change the password (or disable the UI) when installing Mirantis k0rdent Enterprise. If you do not, anyone with access to the management cluster's network can log into the UI and deploy or affect resources in the Mirantis k0rdent Enterprise environment.

To change the password, add the following to the installation command below:

--set k0rdent-ui.auth.basic.password='<NEW_PASSWORD>'

To disable the UI, use:

--set kordent-ui.enabled=false

Install Mirantis k0rdent Enterprise#

You install Mirantis k0rdent Enterprise via Helm chart:

helm install kcm oci://registry.mirantis.com/k0rdent-enterprise/charts/k0rdent-enterprise --version 1.1.0 -n kcm-system --create-namespace <UI_CONFIG>

Important

Don't forget to set the UI configuration to modify the default username and password or disable the UI before deploying, as noted above. If you do not, the UI will be enabled with a default username and password, potentially leaving the management cluster open to attack by anyone able to access the network it's on.

Pulled: registry.mirantis.com/k0rdent-enterprise/charts/k0rdent-enterprise:1.1.0
Digest: sha256:b51693108d167fe0de851ae04ec1caf7865745e8aa27049bc1fab47693ab9f7c
NAME: kcm
LAST DEPLOYED: Wed Aug 13 2025 08:42:36 2025
NAMESPACE: kcm-system
STATUS: deployed
REVISION: 1
TEST SUITE: None
NOTES:
k0rdent enterprise chart has been installed.
Please make sure to change the auth method or set a new password for basic auth by
creating a secret and referencing it in `k0rdent-ui.auth.basic.secretKeyRef`

The helm chart deploys the KCM operator and prepares the environment, and KCM then proceeds to deploy the various subcomponents, including CAPI. The entire process takes a few minutes.

Cleanup: Uninstall Mirantis k0rdent Enterprise#

And of course when you need to clean up, you can use helm as well. Follow these steps:

  1. Remove any ClusterDeployment objects in the cluster.

  2. Delete the Management object:

    kubectl delete management.k0rdent kcm

  3. Remove the kcm Helm release:

    helm uninstall kcm -n kcm-system

  4. Finally, remove the kcm-system namespace:

    kubectl delete ns kcm-system