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.

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.

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:

Before you begin

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.38.1

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.38.1-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