Open source

Install the 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, which includes free forever access to 10k metrics, 50GB logs, 50GB traces, 500VUh k6 testing & more.

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

If object storage is configured, this chart configures Loki to run read and write targets in a scalable mode, highly available architecture (3 replicas of each) designed to work with AWS S3 object storage. It will also configure meta-monitoring of metrics and logs.

It is not possible to run the scalable mode with the filesystem storage.

Before you begin:

  • Helm 3 or above. See Installing Helm.
  • A running Kubernetes cluster.
  • A Prometheus operator installation in case meta-monitoring should be used.

To deploy Loki in 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:

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

      Consult the Reference for configuring other storage providers.

    • Define the AWS S3 credentials in the file.

  4. Upgrade the Loki deployment with this command.

    helm upgrade --values values.yaml loki grafana/loki