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.
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.
Run Grafana Agent in static 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 YAML configuration file on your computer.
Run a Linux Docker container
To run a Grafana Agent Docker container on Linux, run the following command in a terminal window:
docker run \
-v WAL_DATA_DIRECTORY:/etc/agent/data \
-v CONFIG_FILE_PATH:/etc/agent/agent.yaml \
grafana/agent:v0.40.5
Replace CONFIG_FILE_PATH
with the configuration file path on your Linux host system.
Note
For the flags to work correctly, you must expose the paths on your Linux host to the Docker container through a bind mount.
Run a Windows Docker container
To run a Grafana Agent Docker container on Windows, run the following command in a Windows command prompt:
docker run ^
-v WAL_DATA_DIRECTORY:C:\etc\grafana-agent\data ^
-v CONFIG_FILE_PATH:C:\etc\grafana-agent ^
grafana/agent:v0.40.5-windows
Replace the following:
CONFIG_FILE_PATH
: The configuration file path on your Windows host system.WAL_DATA_DIRECTORY
: the directory used to store your metrics before sending them to Prometheus. Old WAL data is cleaned up every hour and is used for recovery if the process crashes.
Note
For the flags to work correctly, you must expose the paths on your Windows host to the Docker container through a bind mount.