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.

Open source

Configure storage

The scalable installation requires a managed object store such as AWS S3 or Google Cloud Storage or a self-hosted store such as Minio. The single binary installation can only use the filesystem for storage.

This guide assumes Loki will be installed in on of the modes above and that a values.yaml has been created.

To use a managed object store:

  1. Set the type of storage in values.yaml to gcs or s3.

  2. Configure the storage client under or

To install Minio alongside Loki:

  1. Change the configuration in values.yaml:

    • Enable Minio
      enabled: true

To grant access to S3 via an IAM role without providing credentials:

  1. Provision an IAM role, policy and S3 bucket as described in Storage.

    • If the Terraform module was used note the annotation emitted by terraform output -raw annotation.
  2. Add the IAM role annotation to the service account in values.yaml:

        "": "arn:aws:iam::<account id>:role/<role name>:
  3. Configure the storage:

        type: "s3"
          region: eu-central-1
          chunks: <bucket name>
          ruler: <bucket name>
          admin: <bucket name>

    Note that endpoint, secretAccessKey and accessKeyId have been omitted.