Menu

Caution

Grafana Alloy is the new name for our distribution of the OTel collector. Grafana Agent has been deprecated and is in Long-Term Support (LTS) through October 31, 2025. Grafana Agent will reach an End-of-Life (EOL) on November 1, 2025. Read more about why we recommend migrating to Grafana Alloy.

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

Documentationbreadcrumb arrow Grafana Agentbreadcrumb arrow Flow modebreadcrumb arrow Get startedbreadcrumb arrow Installbreadcrumb arrow Docker
Open source

Run Grafana Agent Flow in a Docker container

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

Before you begin

  • Install Docker on your computer.

  • Create and save a Grafana Agent Flow River configuration file on your computer, for example:

    river 
    logging {
  level  = "info"
  format = "logfmt"
}

Run a Linux Docker container

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

shell 
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 the following:

  • <CONFIG_FILE_PATH>: 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 Flow 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 Flow as a Windows Docker container, run the following command in a terminal window:

shell 
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 the following:

  • <CONFIG_FILE_PATH>: 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 Flow 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.

Verify

To verify that Grafana Agent Flow is running successfully, navigate to http://localhost:12345 and make sure the Grafana Agent Flow UI loads without error.