Open source

Install the simple scalable Helm chart

This Helm Chart deploys Grafana Loki on Kubernetes.

This chart configures Loki to run read, write, and backend targets in a scalable mode, highly available architecture designed to work with AWS S3 object storage. The chart also supports self-monitoring or meta-monitoring by deploying Grafana Agent to monitor Loki itself, by scraping its metrics and logs.

The default Helm chart deploys the following components:

  • Read component (3 replicas)
  • Write component (3 replicas)
  • Backend component (3 replicas)
  • Loki Canary (1 DaemonSet)
  • Gateway (1 NGINX replica)
  • Minio (optional, if minio.enabled=true)
  • Grafana Agent Operator + Grafana Agent (1 DaemonSet) - configured to monitor the Loki application.

It is not recommended to run scalable mode with filesystem storage.


  • Helm 3 or above. See Installing Helm.
  • A running Kubernetes cluster.
  • (Optional) A Memcached deployment for better query performance. For information on configuring Memcached, refer to caching section.

To deploy Loki in simple scalable mode:

  1. Add Grafana’s chart repository to Helm:

    helm repo add grafana
  2. Update the chart repository:

    helm repo update
  3. Configure the object storage:

    • Create the configuration file values.yaml. The example below illustrates a s3 configuration:

            chunks: chunks
            ruler: ruler
            admin: admin
          type: s3
            endpoint: <endpoint>
            region: <AWS region>
            secretAccessKey: <AWS secret access key>
            accessKeyId: <AWS access key ID>
            s3ForcePathStyle: false
            insecure: false

      To configure other storage providers, refer to the Helm Chart Reference.

    • If you’re just trying things, you can use the following configuration, that sets MinIO as storage:

        enabled: true
  4. Install or upgrade the Loki deployment.

    • To install:
      helm install --values values.yaml loki grafana/loki
    • To upgrade:
      helm upgrade --values values.yaml loki grafana/loki

Next Steps

Configure an agent to send log data to Loki.