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.
Open source
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:
shell
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:
shell
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.
Next steps
Was this page helpful?
Related documentation
Related resources from Grafana Labs
Additional helpful documentation, links, and articles:
Video
Building advanced Grafana dashboards
In this webinar, we’ll demo how to build and format Grafana dashboards.
Video
Intro to Alerting with Grafana
Master alerting with Grafana: Navigate the complexities, reduce false positives, and boost reliability for your systems.
Video
Intro to Kubernetes monitoring in Grafana Cloud
In this webinar you’ll learn how Grafana offers developers and SREs a simple and quick-to-value solution for monitoring their Kubernetes infrastructure.