---
title: "Install the simple scalable Helm chart | Grafana Loki documentation"
description: "Install Loki in scalable mode."
---

> For a curated documentation index, see [llms.txt](/llms.txt). For the complete documentation index, see [llms-full.txt](/llms-full.txt).

# Install the simple scalable Helm chart

> You can use Grafana Cloud to avoid installing, maintaining, and scaling your own instance of Grafana Loki. [Create a free account to get started](/auth/sign-up/create-user?pg=docs-loki-v2.9.x-setup-install-helm-install-scalable), which includes free forever access to 10k metrics, 50GB logs, 50GB traces, 500VUh k6 testing & more.

This Helm Chart installation runs the Grafana Loki cluster within a Kubernetes cluster.

If object storge is configured, this chart configures Loki to run `read` and `write` targets in a [scalable mode](../../../../get-started/deployment-modes/#simple-scalable), highly available architecture (3 replicas of each) designed to work with AWS S3 object storage. It will also configure meta-monitoring of metrics and logs.

It is not possible to run the scalable mode with the `filesystem` storage.

**Before you begin:**

- Helm 3 or above. See [Installing Helm](https://helm.sh/docs/intro/install/).
- A running Kubernetes cluster.
- A Prometheus operator installation in case meta-monitoring should be used.
- Optionally a Memcached deployment for better performance. Consult the [caching section](../../../../operations/caching/) on how to configure Memcached.

**To deploy Loki in scalable mode:**

1. Add [Grafana’s chart repository](https://github.com/grafana/helm-charts) to Helm:
   
   Bash ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy
   
   ```bash
   helm repo add grafana https://grafana.github.io/helm-charts
   ```
2. Update the chart repository:
   
   Bash ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy
   
   ```bash
   helm repo update
   ```
3. Configure the object storage:
   
   - Create the configuration file `values.yaml`. The example below illustrates a s3 configuration:
     
     YAML ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy
     
     ```yaml
     loki:
       storage:
         bucketNames:
           chunks: chunks
           ruler: ruler
           admin: admin
         type: s3
         s3:
           endpoint: <endpoint>
           region: <AWS region>
           secretAccessKey: <AWS secret access key>
           accessKeyId: <AWS access key ID>
           s3ForcePathStyle: false
           insecure: false
     ```
     
     Consult the [Reference](../reference/) for configuring other storage providers.
   - If you’re just trying things, you can use the following configuration instead, that sets MinIO as storage:
     
     YAML ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy
     
     ```yaml
     minio:
       enabled: true
     ```
4. Install or upgrade the Loki deployment.
   
   - To install:
     
     Bash ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy
     
     ```bash
     helm install --values values.yaml loki grafana/loki
     ```
   - To upgrade:
     
     Bash ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy
     
     ```bash
     helm upgrade --values values.yaml loki grafana/loki
     ```