Menu

This is documentation for the next version of Agent. For the latest stable release, go to the latest 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