Install the monolithic Helm chart

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, 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.
A running Kubernetes cluster

To deploy Loki in monolithic mode:

Add Grafana’s chart repository to Helm:

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

Update the chart repository:
bash
```
helm repo update
```

Create the configuration file values.yaml:

If running a single replica of Loki, configure the filesystem storage:

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:

loki:
  commonConfig:
    replication_factor: 3
  storage:
    bucketNames:
      chunks: loki-chunks
      ruler: loki-ruler
      admin: loki-admin
    type: 's3'
    bucketNames:
      chunks: loki-chunks
      ruler: loki-ruler
      admin: loki-admin
    s3:
      endpoint: foo.aws.com
      region: <AWS region>
      secretAccessKey: supersecret
      accessKeyId: secret
      s3ForcePathStyle: false
      insecure: false
singleBinary:
  replicas: 3

Deploy the Loki cluster using one of these commands.
- Deploy with the defined configuration:
  bash
```
helm install --values values.yaml loki grafana/loki
```
- Deploy with the defined configuration in a custom Kubernetes cluster namespace:
  bash
```
helm install --values values.yaml loki --namespace=loki grafana/loki
```