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

Grafana Agent

Flow mode

Set up flow mode

Install flow mode

Docker

Open source

Run Grafana Agent in flow mode in a Docker container

Grafana Agent is available as a Docker container image on the following platforms:

Linux containers for AMD64 and ARM64.
Windows containers for AMD64.

Before you begin

Install Docker on your computer.
Create and save a Grafana Agent River configuration file on your computer, for example:
river
```
logging {
  level  = "info"
  format = "logfmt"
}
```

Run a Linux Docker container

To run Grafana Agent in flow mode as a Linux Docker container, run the following command in a terminal window:

docker run \
  -e AGENT_MODE=flow \
  -v CONFIG_FILE_PATH:/etc/agent/config.river \
  -p 12345:12345 \
  grafana/agent:latest \
    run --server.http.listen-addr=0.0.0.0:12345 /etc/agent/config.river

Replace CONFIG_FILE_PATH with the path of the configuration file on your host system.

You can modify the last line to change the arguments passed to the Grafana Agent binary. Refer to the documentation for run for more information about the options available to the run command.

Note: Make sure you pass --server.http.listen-addr=0.0.0.0:12345 as an argument as shown in the example above. If you don’t pass this argument, the debugging UI won’t be available outside of the Docker container.

Run a Windows Docker container

To run Grafana Agent in flow mode as a Windows Docker container, run the following command in a terminal window:

docker run \
  -e AGENT_MODE=flow \
  -v CONFIG_FILE_PATH:C:\etc\grafana-agent\config.river \
  -p 12345:12345 \
  grafana/agent:latest-windows \
    run --server.http.listen-addr=0.0.0.0:12345 C:\etc\grafana-agent\config.river

Replace CONFIG_FILE_PATH with the path of the configuration file on your host system.

You can modify the last line to change the arguments passed to the Grafana Agent binary. Refer to the documentation for run for more information about the options available to the run command.

Note: Make sure you pass --server.http.listen-addr=0.0.0.0:12345 as an argument as shown in the example above. If you don’t pass this argument, the debugging UI won’t be available outside of the Docker container.