> ## 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.

# Cluster Settings and Storage Defaults

> Configure storage classes and access modes for consistent deployments

## Why Settings Matter

Cluster-level settings reduce deployment drift by standardizing how persistent storage is provisioned.

## Settings Model

```mermaid theme={null}
flowchart LR
    A[Discover Storage Classes] --> B[Choose Default Storage Class]
    B --> C[Set Default Access Mode]
    C --> D[Save Cluster Settings]
    D --> E[Applied to New Deployments]
```

## Configure Default Storage Class

1. Open **Clusters** and select the target cluster.
2. Go to **Settings**.
3. Load available storage classes returned by the cluster.
4. Select the preferred default class.

## Configure Access Mode

1. Pick default access mode (`ReadWriteOnce`, `ReadWriteMany`, etc.).
2. Prefer the recommended mode shown by storage class metadata.
3. Save changes and verify values persist on reload.

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

## Validation Checklist

* Storage class list loads without API errors.
* Selected values remain after refresh.
* New deployments inherit expected storage defaults.

## Operational Guardrails

<Check>
  Use production-approved storage classes only.
</Check>

<Check>
  Document rationale when deviating from recommended access mode.
</Check>

<Check>
  Revalidate settings after cluster upgrades or CSI changes.
</Check>

## Troubleshooting Signals

```mermaid theme={null}
flowchart LR
    A[Settings Load Fails] --> B[Check Cluster Connectivity]
    B --> C[Confirm Storage Class API Response]
    C --> D[Retry Save]
    D --> E[Escalate with Logs if Persistent]
```
