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

# Quick Start

> Register and validate your first cluster in Bud

## Step 1: Open the Clusters Module

1. Sign in to Bud AI Foundry.
2. Click **Clusters** from the side menu.
3. Confirm you can access the cluster list page.

## Step 2: Add a Cluster

1. Click **+ Cluster**.
2. Choose one onboarding path:
   * **Create New Cluster** for cloud-provisioned flow.
   * **Connect to Existing Cluster** for already-running Kubernetes.
3. Provide required details (name, provider/context, ingress URL, and configuration file where applicable).
4. Submit to start onboarding.

<img src="https://mintcdn.com/budecosystem-b7b14df4/VWVW0RGNFnJu1JHC/images/image-30.png?fit=max&auto=format&n=VWVW0RGNFnJu1JHC&q=85&s=341945bc8e6cc7945f7beb554954e3bb" alt="Image" width="1920" height="873" data-path="images/image-30.png" />

## Step 3: Verify Cluster Registration

1. Return to the cluster listing.
2. Locate your new cluster.
3. Confirm hardware summary and status are visible.

## Step 4: Validate Health and Capacity

1. Open the cluster detail page.
2. On **General**, verify nodes and available resources.
3. Open **Nodes** and check ready status and recent events.

<Frame>
  <img src="https://mintcdn.com/budecosystem-b7b14df4/VWVW0RGNFnJu1JHC/images/image-31.png?fit=max&auto=format&n=VWVW0RGNFnJu1JHC&q=85&s=780091af15c59a2a25dfeba143e1d795" alt="Image" width="1920" height="872" data-path="images/image-31.png" />
</Frame>

## Step 5: Set Default Storage Behavior

1. Open the **Settings** tab.
2. Select a default storage class.
3. Choose access mode (for example, `ReadWriteOnce` or `ReadWriteMany`).
4. Save settings for future deployments.

<img src="https://mintcdn.com/budecosystem-b7b14df4/VWVW0RGNFnJu1JHC/images/image-32.png?fit=max&auto=format&n=VWVW0RGNFnJu1JHC&q=85&s=747fbac65af68361a35791b7132face0" alt="Image" width="1920" height="870" data-path="images/image-32.png" />

## Quick Start Flow

```mermaid theme={null}
flowchart LR
    A[Open Clusters] --> B[Add Cluster]
    B --> C[Confirm in Cluster List]
    C --> D[Check General and Nodes Tabs]
    D --> E[Set Storage Defaults]
    E --> F[Ready for Deployments]
```

## Next Steps

<CardGroup cols={2}>
  <Card icon="server" href="/clusters/creating-first-cluster" title="Creating Your First Cluster">
    Complete guided setup with operational checks
  </Card>

  <Card icon="screwdriver-wrench" href="/clusters/troubleshooting" title="Troubleshooting">
    Resolve common registration and health issues
  </Card>
</CardGroup>