Important: This documentation is about an older version. It's relevant only to the release noted, many of the features and functions have been updated or replaced. Please view the current version.

Set up

Install

Install using Helm

Install monolithic Loki

Open source

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 and set the deployment mode to SingleBinary, this chart configures Loki to run the all target in a monolithic mode, designed to work with the filesystem storage configuration. It will also configure meta-monitoring of metrics and logs.

Note
You must specify commonConfig.replication_factor: 1 if you are only using 1 replica, otherwise requests will fail.

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:

deploymentMode: SingleBinary
loki:
  commonConfig:
    replication_factor: 1
  storage:
    type: 'filesystem'
  schemaConfig:
    configs:
    - from: "2024-01-01"
      store: tsdb
      index:
        prefix: loki_index_
        period: 24h
      object_store: filesystem # we're storing on filesystem so there's no real persistence here.
      schema: v13
singleBinary:
  replicas: 1
read:
  replicas: 0
backend:
  replicas: 0
write:
  replicas: 0

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
  schemaConfig:
    configs:
    - from: "2024-01-01"
      store: tsdb
      index:
        prefix: loki_index_
        period: 24h
      object_store: filesystem
      schema: v13
  storage:
    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
```