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

Documentation

Grafana Alloy

Get started

Install

Linux

Open source

Install Grafana Alloy on Linux

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/
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

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

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 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/rpm.grafana.repo
suse-opensuse
sudo zypper removerepo grafana