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

Contributing to Loki

Loki uses GitHub to manage reviews of pull requests:

  • If you have a trivial fix or improvement, go ahead and create a pull request.
  • If you plan to do something more involved, discuss your ideas on the relevant GitHub issue (creating one if it doesn’t exist).

Steps to contribute

To contribute to Loki, you must clone it into your $GOPATH and add your fork as a remote.

$ git clone $GOPATH/src/
$ cd $GOPATH/src/
$ git remote add fork <FORK_URL>

# Make some changes!

$ git add .
$ git commit -m "docs: fix spelling error"
$ git push -u fork HEAD

# Open a PR!

Note that if you downloaded Loki using go get, the message package no Go files in /go/src/ is normal and requires no actions to resolve.


While go install ./cmd/loki works, the preferred way to build is by using make:

  • make loki: builds Loki and outputs the binary to ./cmd/loki/loki

  • make promtail: builds Promtail and outputs the binary to ./clients/cmd/promtail/promtail

  • make logcli: builds LogCLI and outputs the binary to ./cmd/logcli/logcli

  • make loki-canary: builds Loki Canary and outputs the binary to ./cmd/loki-canary/loki-canary

  • make docker-driver: builds the Loki Docker Driver and installs it into Docker.

  • make images: builds all Docker images (optionally suffix the previous binary commands with -image, e.g., make loki-image).

These commands can be chained together to build multiple binaries in one go:

# Builds binaries for Loki, Promtail, and LogCLI.
$ make loki promtail logcli

Contribute to the Helm Chart

The official Loki helm charts can be found in the Grafana Helm Charts Repo.