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.

Documentationbreadcrumb arrow Grafana Agentbreadcrumb arrow Flow modebreadcrumb arrow Set up Grafana Agent Flowbreadcrumb arrow Install Grafana Agent Flowbreadcrumb arrow Linux
Open source

Install or uninstall Grafana Agent Flow on Linux

You can install Grafana Agent Flow as a systemd service on Linux.

Install

To install Grafana Agent Flow on Linux, run the following commands in a terminal window.

  1. Import the GPG key and add the Grafana package repository.

    Debian-Ubuntu 
    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
    RHEL-Fedora 
    wget -q -O gpg.key https://rpm.grafana.com/gpg.key
sudo rpm --import gpg.key
echo -e '[grafana]\nname=grafana\nbaseurl=https://rpm.grafana.com\nrepo_gpgcheck=1\nenabled=1\ngpgcheck=1\ngpgkey=https://rpm.grafana.com/gpg.key\nsslverify=1
sslcacert=/etc/pki/tls/certs/ca-bundle.crt' | sudo tee /etc/yum.repos.d/grafana.repo
    SUSE-openSUSE 
    wget -q -O gpg.key https://rpm.grafana.com/gpg.key
sudo rpm --import gpg.key
sudo zypper addrepo https://rpm.grafana.com grafana

  2. Update the repositories.

    Debian-Ubuntu 
    sudo apt-get update
    RHEL-Fedora 
    yum update
    SUSE-openSUSE 
    sudo zypper update

  3. Install Grafana Agent Flow.

    Debian-Ubuntu 
    sudo apt-get install grafana-agent-flow
    RHEL-Fedora 
    sudo dnf install grafana-agent-flow
    SUSE-openSUSE 
    sudo zypper install grafana-agent-flow

Uninstall

To uninstall Grafana Agent Flow on Linux, run the following commands in a terminal window.

  1. Stop the systemd service for Grafana Agent Flow.

    All-distros 
    sudo systemctl stop grafana-agent-flow

  2. Uninstall Grafana Agent Flow.

    Debian-Ubuntu 
    sudo apt-get remove grafana-agent-flow
    RHEL-Fedora 
    sudo dnf remove grafana-agent-flow
    SUSE-openSUSE 
    sudo zypper remove grafana-agent-flow

  3. Optional: Remove the Grafana repository.

    Debian-Ubuntu 
    sudo rm -i /etc/apt/sources.list.d/grafana.list
    RHEL-Fedora 
    sudo rm -i /etc/yum.repos.d/rpm.grafana.repo
    SUSE-openSUSE 
    sudo zypper removerepo grafana

Next steps