Skip to main content

Connecting Clusters

KubeAgentiX connects to your Kubernetes clusters using your existing kubeconfig.

Automatic Detection​

KubeAgentiX automatically reads your kubeconfig from the default location:

  • macOS/Linux: ~/.kube/config
  • Windows: %USERPROFILE%\.kube\config

All contexts defined in your kubeconfig will appear in the cluster dropdown.

Switching Clusters​

  1. Click the cluster dropdown in the top-left corner
  2. Select the cluster you want to connect to
  3. KubeAgentiX will verify the connection

Supported Cluster Types​

KubeAgentiX works with any Kubernetes cluster:

  • Cloud: EKS, GKE, AKS, DigitalOcean, Linode
  • Local: minikube, kind, Docker Desktop, Rancher Desktop
  • On-premise: kubeadm, OpenShift, Rancher

Custom Kubeconfig​

To use a different kubeconfig file:

  1. Open Settings → Kubernetes
  2. Set the Custom kubeconfig path
  3. Click Apply

Troubleshooting​

Cluster not appearing​

Make sure your kubeconfig is valid:

kubectl config get-contexts

Connection timeout​

Verify you can connect with kubectl:

kubectl cluster-info

Authentication errors​

Check that your credentials are current. For cloud providers:

# AWS EKS
aws eks update-kubeconfig --name my-cluster

# GCP GKE
gcloud container clusters get-credentials my-cluster

# Azure AKS
az aks get-credentials --name my-cluster --resource-group my-rg