Install Grafana Loki with Helm

The Helm chart lets you configure, install, and upgrade Grafana Loki within a Kubernetes cluster.

This guide references the Loki Helm chart version 6.0 or greater and contains the following sections:

If you are installing Grafana Enterprise Logs, follow the GEL Helm installation.

{{< admonition type="note" >}} Grafana Labs maintains the GEL Helm charts in the Loki repository. Grafana Community Champions now maintain the Loki Helm charts in the Grafana-community/helm-charts repo. Issues and pull requests for the Loki chart should be opened against the community repository. {{< /admonition >}}

Deployment Recommendations

Loki is designed to be run in two states:

Monolithic: Recommended when you are running Loki as part of a small meta monitoring stack.
Microservices: For workloads that require high availability and scalability. Loki is deployed in this mode internally at Grafana Labs.

{{< admonition type="tip" >}} Loki can also be deployed in Simple Scalable mode. But Simple Scalable Deployment (SSD) mode is being deprecated. For the best possible experience in production, we recommend deploying Loki in microservices mode. {{< /admonition >}}

Cloud Deployment Guides

The following guides provide step-by-step instructions for deploying Loki on cloud providers:

Reference

You can find reference documentation for the Loki Helm chart in the values.yaml file.