> ## Documentation Index
> Fetch the complete documentation index at: https://hyperbolic.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect to a Managed Kubernetes Cluster

> Install the kubelogin plugin and access your cluster with kubectl via single sign-on

Managed Kubernetes clusters use **single sign-on**: the kubeconfig you download
signs you in through Hyperbolic in your browser and authenticates `kubectl` as
**you** — no shared admin credential, and every action is attributed to your
identity. To run that sign-in, `kubectl` needs the `oidc-login` credential
plugin (**kubelogin**).

## Install the kubelogin plugin

```bash Homebrew (macOS / Linux) theme={null}
brew install kubelogin
```

```bash Krew (macOS / Linux / Windows / ARM) theme={null}
kubectl krew install oidc-login
```

```powershell Chocolatey (Windows) theme={null}
choco install kubelogin
```

All three install the **`kubectl oidc-login`** plugin, which is what the
downloaded kubeconfig uses — so any of them works. Homebrew and Chocolatey also
install a standalone `kubelogin` binary; Krew installs only the plugin form
(invoked as `kubectl oidc-login`). Krew is the most portable option — it works
anywhere `kubectl` does, including Windows and ARM. For manual binaries or other
package managers, see the project's install guide.

> [card] [int128/kubelogin on GitHub](https://github.com/int128/kubelogin)
>
> Source, releases, and full installation options for the kubelogin (`oidc-login`) plugin.

> [!NOTE]
>
> Verify the install with `kubectl oidc-login --version` (works for every install
> method; `kubelogin --version` also works for Homebrew and Chocolatey).

## Connect to your cluster

**1. Download the kubeconfig**

In the [dashboard](https://app.hyperbolic.ai), open **Kubernetes** >
**My Clusters** and select your cluster. Once it's Ready, select
**Download kubeconfig** in the **Connect with kubectl** section
of the **Cluster info** card, or from the cluster actions menu (**⋮**).
The file downloads as `<cluster>.yaml`.

**2. Point kubectl at it**

```bash theme={null}
export KUBECONFIG=~/Downloads/<cluster>.yaml
```

**3. Run any command — your browser opens**

```bash theme={null}
kubectl get nodes
```

The first command opens your browser to sign in with Hyperbolic. After you
sign in, `kubectl` runs as you and the command completes.

> [!NOTE]
>
> Access tokens are short-lived — when one expires, `kubectl` reopens the browser
> to sign in again. Confirm who you're acting as with `kubectl auth whoami`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.