<commit_before>---
title: Install the Helm Chart
menuTitle: Install Loki
description: Install Loki in scalable mode.
aliases:
  - /docs/writers-toolkit/latest/templates/task-template
weight: 100
keywords:
  - keyword
  - key
  - word
---

# Install the Helm Chart
<!-- vale Grafana.Quotes = NO -->
<!-- vale Grafana.Quotes = YES -->

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](../../fundamentals/architecture/deployment-modes/#simple-scalable-deployment-mode), 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.

**To deploy Loki in scalable mode:**

1. Add [Grafana's chart repository](https://github.com/grafana/helm-charts) to Helm:

    ```bash
    helm repo add grafana https://grafana.github.io/helm-charts
    ```

1. Update the chart repository:

    ```bash
    helm repo update
    ```

1. Configure the object storage:

    - Create the configuration file `values.yaml`:

      ```yaml
      storage:
        bucketNames:
          chunks: chunks
          ruler: ruler
          admin: admin
        type: s3
        s3:
          s3: <WHAT SHOULD GO HERE?>
          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 otehr storage providers.

    - Define the AWS S3 credentials in the file.

1. Upgrade the Loki deployment with this command.

   ```bash
   helm upgrade --values values.yaml loki grafana/loki
   ```<commit_msg>Docs: Fix typo in helm scalable installation documentation, object storage section (#7676)<commit_after>---
title: Install the Helm Chart
menuTitle: Install Loki
description: Install Loki in scalable mode.
aliases:
  - /docs/writers-toolkit/latest/templates/task-template
weight: 100
keywords:
  - keyword
  - key
  - word
---

# Install the Helm Chart
<!-- vale Grafana.Quotes = NO -->
<!-- vale Grafana.Quotes = YES -->

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](../../fundamentals/architecture/deployment-modes/#simple-scalable-deployment-mode), 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.

**To deploy Loki in scalable mode:**

1. Add [Grafana's chart repository](https://github.com/grafana/helm-charts) to Helm:

    ```bash
    helm repo add grafana https://grafana.github.io/helm-charts
    ```

1. Update the chart repository:

    ```bash
    helm repo update
    ```

1. Configure the object storage:

    - Create the configuration file `values.yaml`:

      ```yaml
      storage:
        bucketNames:
          chunks: chunks
          ruler: ruler
          admin: admin
        type: s3
        s3:
          s3: <WHAT SHOULD GO HERE?>
          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.

    - Define the AWS S3 credentials in the file.

1. Upgrade the Loki deployment with this command.

   ```bash
   helm upgrade --values values.yaml loki grafana/loki
   ```
{'fraction_non_alphanumeric': 0.09584590392202368, 'fraction_numerical': 0.007890461824089116, 'mean_word_length': 2.841354723707665, 'pattern_counts': {'":': 0, '<': 17, '<?xml version=': 0, '>': 17, 'https://': 6, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '10998', 'n_tokens_mistral': 1274, 'n_tokens_neox': 1203, 'n_words': 471}