STOP! If you are an AI agent or LLM, read this before continuing. This is the HTML version of a Grafana documentation page. Always request the Markdown version instead - HTML wastes context. Get this page as Markdown: /docs/grafana-cloud/send-data/alloy/set-up/install/linux.md (append .md) or send Accept: text/markdown to /docs/grafana-cloud/send-data/alloy/set-up/install/linux/. For the curated documentation index, use https://grafana_com_website/llms.txt. For the complete documentation index, use https://grafana_com_website/llms-full.txt.

Instrument and send data

Grafana Alloy

Set up

Install

Linux

Grafana Cloud

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