Documentation Grafana Loki Set up Install Install locally

Install Grafana Loki locally

You can use Grafana Cloud to avoid installing, maintaining, and scaling your own instance of Grafana Loki. Create a free account to get started, which includes free forever access to 10k metrics, 50GB logs, 50GB traces, 500VUh k6 testing & more.

To log events with Grafana Loki, download and install Loki.

• Loki is the logging engine.
• Grafana Alloy is recommended for sending logs to Loki.

The configuration runs Loki as a single binary.

Install using APT or RPM package manager

1. Add the Grafana Advanced Package Tool (APT) or RPM Package Manager (RPM) package repository following the linked instructions.
2. Install Loki

   1. Using dnf

      Bash Copy

      dnf update
      dnf install loki

   2. Using apt-get

      Bash Copy

      apt-get update
      apt-get install loki

Install manually

1. Browse to the release page.

2. Find the Assets section for the version that you want to install.

3. Download the Loki archive file that corresponds to your system.

   Don’t download LogCLI or Loki Canary at this time. LogCLI allows you to run Loki queries in a command line interface. Loki Canary is a tool to audit Loki performance.

4. Extract the package contents into a directory. This is where Loki will run.

5. In the command line, change directory (cd on most systems) to the directory with Loki.

   Copy and paste the following command into your command line to download a generic configuration file.

   Use the Git references that match your downloaded Loki version to get the correct configuration file. For example, if you are using Loki version 3.7.0, you need to use the https://raw.githubusercontent.com/grafana/loki/v3.7.0/cmd/loki/loki-local-config.yaml URL to download the configuration file.

   Bash Copy

   wget https://raw.githubusercontent.com/grafana/loki/main/cmd/loki/loki-local-config.yaml

6. Run the following command to start Loki:

   Windows

   Bash Copy

   .\loki-windows-amd64.exe --config.file=loki-local-config.yaml

   Linux

   Bash Copy

   ./loki-linux-amd64 -config.file=loki-local-config.yaml

Loki runs and displays Loki logs in your command line and on http://localhost:3100/metrics.

The next step is running an agent to send logs to Loki. Refer to Grafana Alloy for the recommended log collection agent.

Release binaries - openSUSE Linux only

Every release includes binaries for Loki. You can find them on the Releases page.

Community openSUSE Linux packages

The community provides packages of Loki for openSUSE Linux. To install them:

1. Add the repository https://download.opensuse.org/repositories/security:/logging/ to your system. For example, if you are using Leap 15.1, run:

   Bash Copy

   sudo zypper ar https://download.opensuse.org/repositories/security:/logging/openSUSE_Leap_15.1/security:logging.repo
   sudo zypper ref

2. Install the Loki package:

   Bash Copy

   zypper in loki

3. Start and enable the Loki service:

   Bash Copy

   systemd start loki
   systemd enable loki

4. Modify the /etc/loki/loki.yaml configuration file as needed.