This is documentation for the next version of Grafana Alloy Documentation. For the latest stable release, go to the latest version.

Documentation

Grafana Alloy

Set up

Install

Linux

Open source

Install Grafana Alloy on Linux

Start your learning experience with Grafana Learning Paths

Grafana Learning Paths provide a clear, structured path that leads you from beginner concepts to advanced use cases. Learn about this Grafana feature on Monitor a Linux server in Grafana Cloud.

Start learning

You can install Alloy as a systemd service on Linux.

Before you begin

Some Debian-based cloud Virtual Machines don’t have GPG installed by default. To install GPG in your Linux Virtual Machine, run the following command in a terminal window.

sudo apt install gpg

Install

To install Alloy on Linux, run the following commands in a terminal window.

Import the GPG key and add the Grafana package repository.

sudo mkdir -p /etc/apt/keyrings
sudo wget -O /etc/apt/keyrings/grafana.asc https://apt.grafana.com/gpg-full.key
sudo chmod 644 /etc/apt/keyrings/grafana.asc
echo "deb [signed-by=/etc/apt/keyrings/grafana.asc] https://apt.grafana.com stable main" | sudo tee /etc/apt/sources.list.d/grafana.list

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\nsslcacert=/etc/pki/tls/certs/ca-bundle.crt' | sudo tee /etc/yum.repos.d/grafana.repo

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.
Debian-Ubuntu
sudo apt-get update
RHEL-Fedora
yum update
SUSE-openSUSE
sudo zypper update
Install Alloy.
Debian-Ubuntu
sudo apt-get install alloy
RHEL-Fedora
sudo dnf install alloy
SUSE-openSUSE
sudo zypper -r grafana install alloy

Uninstall

To uninstall Alloy on Linux, run the following commands in a terminal window.

Stop the systemd service for Alloy.
All-distros
```
sudo systemctl stop alloy
```
Uninstall Alloy.
Debian-Ubuntu
sudo apt-get remove alloy
RHEL-Fedora
sudo dnf remove alloy
SUSE-openSUSE
sudo zypper remove alloy
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/grafana.repo
SUSE-openSUSE
sudo zypper removerepo grafana