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

Open source

Releasing Loki Build Image

The loki-build-image is the Docker image used to run tests and build Grafana Loki binaries in CI.

The build and publish process of the image is triggered upon a merge to main if any changes were made in the folder ./loki-build-image/.

To build and use the loki-build-image:

Step 1

  1. Create a branch with the desired changes to the Dockerfile.
  2. Update the version tag of the loki-build-image pipeline defined in .drone/drone.jsonnet (search for pipeline('loki-build-image')) to a new version number (try to follow semver).
  3. Run DRONE_SERVER= DRONE_TOKEN=<token> make drone and commit the changes to the same branch.
    1. The <token> is your personal drone token, which can be found by navigating to
  4. Create a PR.
  5. Once approved and merged to main, the image with the new version is built and published.


    Keep an eye on for the build after merging (example).

Step 2

  1. Create a branch.
  2. Update the BUILD_IMAGE_VERSION variable in the Makefile.
  3. Run loki-build-image/ <new-version> to update all the references.
  4. Run DRONE_SERVER= DRONE_TOKEN=<token> make drone to update the Drone config to use the new build image.
  5. Create a new PR.