GitHub Repository: aos/grafana-agent
Path: blob/main/docs/sources/flow/install/linux.md
⁴⁰⁹⁶ views

---

title: Linux systems
weight: 300

---

Install Grafana Agent Flow on Linux systems

Grafana Agent Flow can be installed as a systemd service on various AMD64 and ARM64 Linux systems:

Install on Debian-based systems

To install Grafana Agent Flow on Debian-based systems (such as Debian or Ubuntu), complete the following steps:

Open a terminal and run the following command to install Grafana's package repository:

mkdir -p /etc/apt/keyrings/
wget -q -O - https://apt.grafana.com/gpg.key | gpg --dearmor > /etc/apt/keyrings/grafana.gpg
echo "deb [signed-by=/etc/apt/keyrings/grafana.gpg] https://apt.grafana.com stable main" | tee /etc/apt/sources.list.d/grafana.list

With the repository installed, update the list of available packages:
```
sudo apt-get update
```

Install the Grafana Agent Flow package:

sudo apt-get install grafana-agent-flow

Install on RedHat-based systems

To install Grafana Agent Flow on RedHat-based systems (such as CentOS, Fedora, or RedHat Enterprise Linux), complete the following steps:

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

Verify that the repository is properly configured using yum-config-manager:
```
yum-config-manager grafana
```
Install the Grafana Agent Flow package:
```
sudo yum install grafana-agent-flow
```

Operation guide

After installing Grafana Agent Flow on Linux, it will be exposed as a systemd service.

Run Grafana Agent Flow

To run Grafana Agent Flow, run the following command in a terminal:

sudo systemctl start grafana-agent-flow

To check the status of Grafana Agent Flow, run the following command in a terminal:

sudo systemctl status grafana-agent-flow

Run Grafana Agent Flow on startup

To automatically run Grafana Agent Flow when the system starts, run the following command in a terminal:

sudo systemctl enable grafana-agent-flow.service

Configuring Grafana Agent Flow

To configure Grafana Agent Flow when installed on Linux, perform the following steps:

Edit the default configuration file at /etc/grafana-agent-flow.river.
Run the following command in a terminal to reload the configuration file:
```
sudo systemctl reload grafana-agent-flow
```

To change the configuration file used by the service, perform the following steps:

Edit the environment file for the service:
- Debian-based systems: edit /etc/default/grafana-agent-flow
- RedHat-based systems: edit /etc/sysconfig/grafana-agent-flow
Change the contents of the CONFIG_FILE environment variable to point to the new configuration file to use.

Restart the Grafana Agent Flow service:

sudo systemctl restart grafana-agent-flow

Passing additional command-line flags

By default, the Grafana Agent Flow service will launch with the [run][] command, passing the following flags:

--storage.path=/var/lib/grafana-agent-flow

To pass additional command-line flags to the Grafana Agent Flow binary, perform the following steps:

Edit the environment file for the service:
- Debian-based systems: edit /etc/default/grafana-agent-flow
- RedHat-based systems: edit /etc/sysconfig/grafana-agent-flow
Change the contents of the CUSTOM_ARGS environment variable to specify command-line flags to pass.

Restart the Grafana Agent Flow service:

sudo systemctl restart grafana-agent-flow

To see the list of valid command-line flags that can be passed to the service, refer to the documentation for the [run][] command.

[run]: {{< relref "../reference/cli/run.md" >}}

Exposing the UI to other machines

By default, Grafana Agent Flow listens on the local network for its HTTP server. This prevents other machines on the network from being able to access the [UI for debugging][UI].

To expose the UI to other machines, complete the following steps:

Follow Passing additional command-line flags to edit command line flags passed to Grafana Agent Flow, including the following customizations:
1. Add the following command line argument to CUSTOM_ARGS:
```
--server.http.listen-addr=LISTEN_ADDR:12345
```
  Replace LISTEN_ADDR with an address which other machines on the network have access to, like the network IP address of the machine Grafana Agent Flow is running on.
  To listen on all interfaces, replace LISTEN_ADDR with 0.0.0.0.

[UI]: {{< relref "../monitoring/debugging.md#grafana-agent-flow-ui" >}}

Viewing Grafana Agent Flow logs

Logs of Grafana Agent Flow can be found by running the following command in a terminal:

sudo journalctl -u grafana-agent-flow