Create a cluster

Create a shared managed cluster and connect kubectl to it.

Create the cluster

CLI

kupe cluster create dev

The command waits for the cluster to reach Running (usually 1–2 minutes).

Console

In console.kupe.cloud:

1. Open Clusters and click Create Cluster.
2. Name it dev, leave the defaults (shared nodes, latest version).
3. Click Create and wait for Phase: Running.

Merge kubeconfig

CLI

kupe cluster kubeconfig dev --merge

This adds a context like kupe-<tenant>-dev to ~/.kube/config.

Console

Open the cluster → CLI Access → download the OIDC kubeconfig, then:

export KUBECONFIG=~/Downloads/dev-oidc.kubeconfig

Verify

kubectl get ns

You should see default, kube-system, argocd, and a few others.

Next

Deploy your first app.

---

For the details behind OIDC vs token kubeconfigs, see Cluster Access.