Set up Grafana AgentRun Grafana Agent on Docker

Run Grafana Agent on Docker

Install Grafana Agent and get it up and running on Docker.

Before you begin

  • Ensure that you have Docker installed.
  • Ensure that you have created a configuration file. In the case of Docker, you install and run the Grafana Agent with a single command. You therefore need to create a configuration file before running Grafana Agent on Docker. For more information on creating a configuration file, refer to Create a configuration file.


  1. Copy and paste the following commands into your command line.
docker run \
  -v /tmp/agent:/etc/agent/data \
  -v /path/to/config.yaml:/etc/agent/agent.yaml \
  1. Replace /tmp/agent with the folder you want to store WAL data in.

    WAL data is where metrics are stored before they are sent to Prometheus. Old WAL data is cleaned up every hour and is used for recovery if the process happens to crash.

  2. Replace /path/to/config.yaml with a path pointing to a valid configuration file.

Note that using paths on your host machine must be exposed to the Docker container through a bind mount for the flags to work properly.


Docker containers run the Grafana Agent using this configuration file.