> ## Documentation Index
> Fetch the complete documentation index at: https://docs.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

<CodeGroup>
  ```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
  ```
</CodeGroup>

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 title="int128/kubelogin on GitHub" icon="github" href="https://github.com/int128/kubelogin">
  Source, releases, and full installation options for the kubelogin (`oidc-login`) plugin.
</Card>

<Note>
  Verify the install with `kubectl oidc-login --version` (works for every install
  method; `kubelogin --version` also works for Homebrew and Chocolatey).
</Note>

## Connect to your cluster

<Steps>
  <Step title="Download the kubeconfig">
    Open your cluster from the **Kubernetes** page in the
    [dashboard](https://app.hyperbolic.ai) and download its kubeconfig
    (`<cluster>.yaml`).
  </Step>

  <Step title="Point kubectl at it">
    ```bash theme={null}
    export KUBECONFIG=~/Downloads/<cluster>.yaml
    ```
  </Step>

  <Step title="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.
  </Step>
</Steps>

<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`.
</Note>


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