---
title: "Install the monolithic Helm chart | Grafana Loki documentation"
description: "Install Loki in monolithic, single binary 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 monolithic 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-monolithic), which includes free forever access to 10k metrics, 50GB logs, 50GB traces, 500VUh k6 testing & more.

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

If you set the `singleBinary.replicas` value to 1, this chart configures Loki to run the `all` target in a [monolithic mode](../../../../get-started/deployment-modes/#monolithic-mode), designed to work with a filesystem storage. It will also configure meta-monitoring of metrics and logs. If you set the `singleBinary.replicas` value to 2 or more, this chart configures Loki to run a *single binary* in a replicated, highly available mode. When running replicas of a single binary, you must configure object storage.

**Before you begin: Software Requirements**

- Helm 3 or above. See [Installing Helm](https://helm.sh/docs/intro/install/).
- A running Kubernetes cluster

**To deploy Loki in monolithic 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. Create the configuration file `values.yaml`:
   
   - If running a single replica of Loki, configure the `filesystem` storage:
     
     YAML ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy
     
     ```yaml
     loki:
       commonConfig:
         replication_factor: 1
       storage:
         type: 'filesystem'
     singleBinary:
       replicas: 1
     ```
   - If running Loki with a replication factor greater than 1, set the desired number replicas and provide object storage credentials:
     
     YAML ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy
     
     ```yaml
     loki:
       commonConfig:
         replication_factor: 3
       storage:
         bucketNames:
           chunks: loki-chunks
           ruler: loki-ruler
           admin: loki-admin
         type: 's3'
         s3:
           endpoint: foo.aws.com
           secretAccessKey: supersecret
           accessKeyId: secret
     singleBinary:
       replicas: 3
     ```
4. Deploy the Loki cluster using one of these commands.
   
   - Deploy with the defined configuration:
     
     Bash ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy
     
     ```bash
     helm install --values values.yaml loki grafana/loki
     ```
   - Deploy with the defined configuration in a custom Kubernetes cluster namespace:
     
     Bash ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy
     
     ```bash
     helm install --values values.yaml loki --namespace=loki grafana/loki
     ```