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.
Install Loki with Docker or Docker Compose
You can install Loki and Promtail with Docker or Docker Compose if you are evaluating, testing, or developing Loki. For production, Grafana recommends installing with Helm or Tanka.
The configuration files associated with these installation instructions run Loki as a single binary.
Prerequisites
- Docker
- Docker Compose (optional, only needed for the Docker Compose install method)
Install with Docker on Linux
Create a directory called
loki
. Makeloki
your current working directory:mkdir loki cd loki
Copy and paste the following commands into your command line to download
loki-local-config.yaml
andpromtail-docker-config.yaml
to yourloki
directory.wget https://raw.githubusercontent.com/grafana/loki/v3.0.0/cmd/loki/loki-local-config.yaml -O loki-config.yaml wget https://raw.githubusercontent.com/grafana/loki/v3.0.0/clients/cmd/promtail/promtail-docker-config.yaml -O promtail-config.yaml
Copy and paste the following commands into your command line to start the Docker containers using the configuration files you downloaded in the previous step.
docker run --name loki -d -v $(pwd):/mnt/config -p 3100:3100 grafana/loki:3.0.0 -config.file=/mnt/config/loki-config.yaml docker run --name promtail -d -v $(pwd):/mnt/config -v /var/log:/var/log --link loki grafana/promtail:3.0.0 -config.file=/mnt/config/promtail-config.yaml
Note
The image is configured to run by default as userloki
with UID10001
and GID10001
. You can use a different user, specially if you are using bind mounts, by specifying the UID with adocker run
command and using--user=UID
with a numeric UID suited to your needs.Verify that your containers are running:
docker container ls
You should see something similar to the following:
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES 9485de9ad351 grafana/promtail:3.0.0 "/usr/bin/promtail -…" About a minute ago Up About a minute promtail cece1df84519 grafana/loki:3.0.0 "/usr/bin/loki -conf…" About a minute ago Up About a minute 0.0.0.0:3100->3100/tcp, :::3100->3100/tcp loki
Verify that Loki is up and running.
- To view readiness, navigate to http://localhost:3100/ready.
- To view metrics, navigate to http://localhost:3100/metrics.
Install with Docker on Windows
- Copy and paste the following commands into your command line to download
loki-local-config.yaml
andpromtail-docker-config.yaml
to yourloki
directory. Note that you will need to replace the<local-path>
in the commands with your local path.
cd "<local-path>"
wget https://raw.githubusercontent.com/grafana/loki/v3.0.0/cmd/loki/loki-local-config.yaml -O loki-config.yaml
wget https://raw.githubusercontent.com/grafana/loki/v3.0.0/clients/cmd/promtail/promtail-docker-config.yaml -O promtail-config.yaml
- Copy and paste the following commands into your command line to start the Docker containers using the configuration files you downloaded in the previous step. Note that you will need to replace the
<local-path>
in the commands with your local path.
docker run --name loki -v <local-path>:/mnt/config -p 3100:3100 grafana/loki:3.0.0 --config.file=/mnt/config/loki-config.yaml
docker run -v <local-path>:/mnt/config -v /var/log:/var/log --link loki grafana/promtail:3.0.0 --config.file=/mnt/config/promtail-config.yaml
Verify that Loki is up and running.
- To view readiness, navigate to http://localhost:3100/ready.
- To view metrics, navigate to http://localhost:3100/metrics.
Install with Docker Compose
Run the following commands in your command line. They work for Windows or Linux systems.
Create a directory called
loki
. Makeloki
your current working directory:mkdir loki cd loki
Copy and paste the following command into your command line to download the
docker-compose
file.wget https://raw.githubusercontent.com/grafana/loki/v3.0.0/production/docker-compose.yaml -O docker-compose.yaml
With
loki
as the current working directory, run the following ‘docker-compose` command:docker-compose -f docker-compose.yaml up
You should see something similar to the following:
✔ Container mydevice-minio-1 Started 0.0s ✔ Container mydevice-flog-1 Started 0.0s ✔ Container mydevice-write-1 Started 0.0s ✔ Container mydevice-read-1 Started 0.0s ✔ Container mydevice-gateway-1 Started 0.0s ✔ Container mydevice-grafana-1 Started 0.0s ✔ Container mydevice-promtail-1 Started 0.0s
Verify that Loki is up and running.
- To view readiness, navigate to http://localhost:3100/ready.
- To view metrics, navigate to http://localhost:3100/metrics.