Create a cluster

Create a shared managed cluster and connect kubectl to it.

Create the cluster

CLI

kupe cluster create dev --cpu-limit 2 --memory-limit 8Gi --storage-limit 50Gi

The --cpu-limit, --memory-limit, and --storage-limit flags are required; there are no resource defaults. The version is optional (omitting it uses the latest supported version). 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 and set its resource limits (CPU, memory, storage), which are required. The version is optional and defaults to the latest supported 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.