# Scale your cluster

Scaling the UltiHash cluster allows you to adjust the number of replicas for core services, such as the storage and deduplicator components, based on workload demand. You may need to scale when workloads increase, resource utilisation remains high, or to improve redundancy and high availability. By increasing the number of replicas, you can handle more concurrent requests, improve throughput, and reduce the impact of node or pod failures. UltiHash is deployed via a Helm chart, which lets you update replica counts for each service and roll out changes across the cluster.

***

### How to scale

To scale the storage and deduplicator services:

1. Update the replica counts using either your values.yaml file or the --set flags in the Helm command.
2. Run the following command:

```
helm upgrade <release_name> oci://registry.ultihash.io/stable/ultihash-cluster \
  -n <namespace> \
  --set storage.replicas=3,deduplicator.replicas=3
```

* Replace \<release\_name> with your Helm release name.
* Replace \<namespace> with the Kubernetes namespace where UltiHash is deployed.
* Adjust the replica counts (3 in the example above) as needed.

To verify that the replicas have been updated, run:

```
kubectl get pods -n <namespace>
```

This will display the current state of all pods in the namespace, showing the updated replica counts for each service.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.ultihash.io/administration/scale-your-cluster.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.