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.
Install Grafana Agent in flow mode on Linux
You can install Grafana Agent in flow mode as a systemd service on Linux.
Install on Debian or Ubuntu
To install Grafana Agent in flow mode on Debian or Ubuntu, run the following commands in a terminal window.
Import the GPG key and add the Grafana package repository:
sudo mkdir -p /etc/apt/keyrings/ wget -q -O - https://apt.grafana.com/gpg.key | gpg --dearmor | sudo tee /etc/apt/keyrings/grafana.gpg > /dev/null echo "deb [signed-by=/etc/apt/keyrings/grafana.gpg] https://apt.grafana.com stable main" | sudo tee /etc/apt/sources.list.d/grafana.list
Update the repositories:
sudo apt-get update
Install Grafana Agent:
sudo apt-get install grafana-agent-flow
Uninstall on Debian or Ubuntu
To uninstall Grafana Agent on Debian or Ubuntu, run the following commands in a terminal window.
Stop the systemd service for Grafana Agent:
sudo systemctl stop grafana-agent-flow
Uninstall Grafana Agent:
sudo apt-get remove grafana-agent-flow
Optional: Remove the Grafana repository:
sudo rm -i /etc/apt/sources.list.d/grafana.list
Install on RHEL or Fedora
To install Grafana Agent in flow mode on RHEL or Fedora, run the following commands in a terminal window.
Import the GPG key:
wget -q -O gpg.key https://rpm.grafana.com/gpg.key sudo rpm --import gpg.key
Create
/etc/yum.repos.d/grafana.repo
with the following content:[grafana] name=grafana baseurl=https://rpm.grafana.com repo_gpgcheck=1 enabled=1 gpgcheck=1 gpgkey=https://rpm.grafana.com/gpg.key sslverify=1 sslcacert=/etc/pki/tls/certs/ca-bundle.crt
Optional: Verify the Grafana repository configuration:
cat /etc/yum.repos.d/grafana.repo
Install Grafana Agent:
sudo dnf install grafana-agent-flow
Uninstall on RHEL or Fedora
To uninstall Grafana Agent on RHEL or Fedora, run the following commands in a terminal window:
Stop the systemd service for Grafana Agent:
sudo systemctl stop grafana-agent-flow
Uninstall Grafana Agent:
sudo dnf remove grafana-agent-flow
Optional: Remove the Grafana repository:
sudo rm -i /etc/yum.repos.d/rpm.grafana.repo
Install on SUSE or openSUSE
To install Grafana Agent in flow mode on SUSE or openSUSE, run the following commands in a terminal window.
Import the GPG key and add the Grafana package repository:
wget -q -O gpg.key https://rpm.grafana.com/gpg.key sudo rpm --import gpg.key sudo zypper addrepo https://rpm.grafana.com grafana
Update the repositories:
sudo zypper update
Install Grafana Agent:
sudo zypper install grafana-agent-flow
Uninstall on SUSE or openSUSE
To uninstall Grafana Agent on SUSE or openSUSE, run the following commands in a terminal:
Stop the systemd service for Grafana Agent:
sudo systemctl stop grafana-agent-flow
Uninstall Grafana Agent:
sudo zypper remove grafana-agent-flow
Optional: Remove the Grafana repository:
sudo zypper removerepo grafana