This is documentation for the next version of Loki. For the latest stable release, go to the latest version.

Open source

Prepare Upgrade guide

The upgrade guide records changes that require user attention or interaction to upgrade to specific Loki version from previous versions.

Before you begin

The upgrade guide in Grafana Loki works as follows.

We have a setup/upgrade/ file that records upgrade information for all Loki releases.


  1. Make sure the upgrade guide is up to date on the release-VERSION_PREFIX branch under the Main/Unreleased section.

  2. On the release-VERSION_PREFIX branch promote Main/Unreleased to VERSION. Example PR.

  3. On the main branch remove entries from Main/Unreleased that are already part of VERSION (YYY-MM-DD).