Docs

Kubernetes Cluster Integration

Learn how to integrate a generic Kubernetes cluster with Cokpit.

Step 1: Prepare Cluster Details

  1. Secret Name

    • Choose a unique name for your cluster secret.
      Example: k8s-cluster-secret
  2. Cluster Name

    • This is the name of your Kubernetes cluster.
      Example: my-kubernetes-cluster

💡 If you are using K3s:
You can install it using the following command:

curl -sfL https://get.k3s.io | INSTALL_K3S_EXEC="server --disable=traefik" sh -
  1. Kube Config
    • Locate your kubeconfig file at ~/.kube/config.

    • Copy the full YAML content — it includes cluster access credentials.

    • For reference, see the official docs:
      Kubernetes kubeconfig documentation

    • To check your cluster name, run:

      kubectl config get-clusters

Step 2: Add Cluster Credentials in Cokpit

  1. Open Cokpit → Integrations → Kubernetes Cluster → Add Secret.
  1. Enter the following details:
    • Secret Name
    • Cluster Name
    • Kube Config
  2. Click Submit to save the cluster credentials.

Once saved, your Kubernetes cluster will be securely connected to Cokpit and ready to use.