--- title: "Install Loki with Docker or Docker Compose | Grafana Loki documentation" description: "Describes how to install Loki using Docker or Docker Compose" --- # Install Loki with Docker or Docker Compose > You can use Grafana Cloud to avoid installing, maintaining, and scaling your own instance of Grafana Loki. [Create a free account to get started](/auth/sign-up/create-user?pg=docs-loki-latest-setup-install-docker), which includes free forever access to 10k metrics, 50GB logs, 50GB traces, 500VUh k6 testing & more. You can install Loki and Alloy 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](https://docs.docker.com/install) - [Docker Compose](https://docs.docker.com/compose/install) (optional, only needed for the Docker Compose install method) ## Install with Docker on Linux 1. Create a directory called `loki`. Make `loki` your current working directory: Bash ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy ```bash mkdir loki cd loki ``` 2. Copy and paste the following command into your command line to download `loki-local-config.yaml` to your `loki` directory. If necessary, update the Loki version numbers in the commands to match your version of Loki. Bash ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy ```bash wget https://raw.githubusercontent.com/grafana/loki/v3.7.0/cmd/loki/loki-local-config.yaml -O loki-config.yaml ``` 3. Copy and paste the following command into your command line to start the Docker container using the configuration file you downloaded in the previous step. If necessary, update the Loki version numbers in the commands to match your version of Loki. Bash ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy ```bash docker run --name loki -d -v $(pwd):/mnt/config -p 3100:3100 grafana/loki:3.7.0 -config.file=/mnt/config/loki-config.yaml ``` > Note > > The image is configured to run by default as user `loki` with UID `10001` and GID `10001`. You can use a different user, specially if you are using bind mounts, by specifying the UID with a `docker run` command and using `--user=UID` with a numeric UID suited to your needs. To send logs to Loki, consider using [Grafana Alloy](/docs/alloy/latest/). 4. Verify that your containers are running: Bash ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy ```bash docker container ls ``` You should see something similar to the following: Bash ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy ```bash CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES cece1df84519 grafana/loki:3.7.0 "/usr/bin/loki -conf…" About a minute ago Up About a minute 0.0.0.0:3100->3100/tcp, :::3100->3100/tcp loki ``` 5. 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 1. Copy and paste the following commands into your command line to download `loki-local-config.yaml` to your `loki` directory. Note that you will need to replace the `` in the commands with your local path. If necessary, update the Loki version numbers in the commands to match your version of Loki. Bash ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy ```bash cd "" wget https://raw.githubusercontent.com/grafana/loki/v3.7.0/cmd/loki/loki-local-config.yaml -O loki-config.yaml ``` 1. Copy and paste the following command into your command line to start the Docker container using the configuration file you downloaded in the previous step. Note that you will need to replace the `` in the commands with your local path. If necessary, update the Loki version numbers in the commands to match your version of Loki. Bash ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy ```bash docker run --name loki -v :/mnt/config -p 3100:3100 grafana/loki:3.7.0 --config.file=/mnt/config/loki-config.yaml ``` To send logs to Loki, consider using [Grafana Alloy](/docs/alloy/latest/). 1. 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. 1. Create a directory called `loki`. Make `loki` your current working directory: Bash ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy ```bash mkdir loki cd loki ``` 2. Copy and paste the following commands into your command line to download the `docker-compose.yaml` and `alloy-local-config.yaml` files. If necessary, update the Loki version numbers in the commands to match your version of Loki. Bash ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy ```bash wget https://raw.githubusercontent.com/grafana/loki/v3.7.0/examples/getting-started/docker-compose.yaml -O docker-compose.yaml wget https://raw.githubusercontent.com/grafana/loki/v3.7.0/examples/getting-started/alloy-local-config.yaml -O alloy-local-config.yaml wget https://raw.githubusercontent.com/grafana/loki/v3.7.0/examples/getting-started/loki-config.yaml -O loki-config.yaml ``` 3. With `loki` as the current working directory, run the following ‘docker-compose\` command: Bash ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy ```bash docker-compose -f docker-compose.yaml up ``` You should see something similar to the following: Bash ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy ```bash ✔ Container loki-loki-1 Started 0.0s ✔ Container loki-grafana-1 Started 0.0s ✔ Container loki-alloy-1 Started 0.0s ``` 4. Verify that Loki is up and running. - To view read path readiness, navigate to http://localhost:3101/ready. - To view read path metrics, navigate to http://localhost:3101/metrics. - To view write path readiness, navigate to http://localhost:3102/ready. - To view write path metrics, navigate to http://localhost:3102/metrics.