# Cluster defaults templates

> ConfigMap templates for cluster-level optimization defaults

---

Site [llms.txt](/llms.txt)

---

The StormForge Agent reads cluster-level optimization defaults from a ConfigMap named `cluster-defaults` in the `stormforge-system` namespace. You can create and manage this ConfigMap using `kubectl` or your GitOps tool. For full management details, see [Configure optimization defaults for the cluster](/docs/configure/cluster-defaults/).

## Check current cluster defaults

To check whether any defaults are already set:

```shell
kubectl describe configmap cluster-defaults -n stormforge-system
```

If you see `Error from server (NotFound): configmaps "cluster-defaults" not found`, no cluster-level defaults are set.

## Optimization templates

The following templates cover the most common cluster-level configurations. Copy the relevant template, review the example values and adjust for your environment, and remove any settings you don't need.

### Balanced optimization (CPU and memory)

```yaml
apiVersion: v1
kind: ConfigMap
metadata:
  name: cluster-defaults
  namespace: stormforge-system
data:
  cluster-defaults.yaml: |
    live.stormforge.io/schedule: "P1D"
    live.stormforge.io/auto-deploy: "Disabled"
    live.stormforge.io/cpu.optimization-goal: "Balanced"
    live.stormforge.io/memory.optimization-goal: "Balanced"
    live.stormforge.io/containers.cpu.optimization-policy: "RequestsAndLimits"
    live.stormforge.io/containers.memory.optimization-policy: "RequestsOnly"
```

### Savings-focused

```yaml
apiVersion: v1
kind: ConfigMap
metadata:
  name: cluster-defaults
  namespace: stormforge-system
data:
  cluster-defaults.yaml: |
    live.stormforge.io/schedule: "P1D"
    live.stormforge.io/auto-deploy: "Disabled"
    live.stormforge.io/cpu.optimization-goal: "Savings"
    live.stormforge.io/memory.optimization-goal: "Savings"
    live.stormforge.io/containers.cpu.optimization-policy: "RequestsAndLimits"
    live.stormforge.io/containers.memory.optimization-policy: "RequestsAndLimits"
    live.stormforge.io/containers.cpu.requests.min: "20m"
    live.stormforge.io/containers.memory.requests.min: "32Mi"
```

### Reliability-focused

```yaml
apiVersion: v1
kind: ConfigMap
metadata:
  name: cluster-defaults
  namespace: stormforge-system
data:
  cluster-defaults.yaml: |
    live.stormforge.io/schedule: "P1D"
    live.stormforge.io/auto-deploy: "Disabled"
    live.stormforge.io/cpu.optimization-goal: "Reliability"
    live.stormforge.io/memory.optimization-goal: "Reliability"
    live.stormforge.io/containers.cpu.optimization-policy: "RequestsOnly"
    live.stormforge.io/containers.memory.optimization-policy: "RequestsOnly"
```

### Automatic deployment enabled

```yaml
apiVersion: v1
kind: ConfigMap
metadata:
  name: cluster-defaults
  namespace: stormforge-system
data:
  cluster-defaults.yaml: |
    live.stormforge.io/schedule: "PT16H"
    live.stormforge.io/auto-deploy: "Enabled"
    live.stormforge.io/cpu.optimization-goal: "Savings"
    live.stormforge.io/memory.optimization-goal: "Savings"
    live.stormforge.io/containers.cpu.optimization-policy: "RequestsAndLimits"
    live.stormforge.io/containers.memory.optimization-policy: "RequestsAndLimits"
    live.stormforge.io/containers.cpu.requests.min: "20m"
    live.stormforge.io/containers.memory.requests.min: "32Mi"
    # Maximum bounds: align with your organization's maximums
    # live.stormforge.io/containers.cpu.requests.max: "16000m"
    # live.stormforge.io/containers.memory.requests.max: "32Gi"
```

## Apply the ConfigMap

```shell
kubectl apply -f FILENAME
```

Then restart the Agent to pick up the changes:

```shell
kubectl rollout restart deployment stormforge-cluster-agent -n stormforge-system
```

## Confirm your changes

```shell
kubectl describe configmap cluster-defaults -n stormforge-system
```

Review the `cluster-defaults.yaml` item in the **Data** section of the output.

## Related topics

- [Configure optimization defaults for the cluster](/docs/configure/cluster-defaults/) — manage defaults using `kubectl` after install
- [Optimization settings and descriptions](/docs/configure/settings/) — complete list of annotation keys