This is documentation for the next version of Loki. For the latest stable release, go to the latest version.
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 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:
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: s3 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:
helm install --values values.yaml loki grafana/loki
Deploy with the defined configuration in a custom Kubernetes cluster namespace:
helm install --values values.yaml loki --namespace=loki grafana/loki