Grafana documentation Set up Install Grafana RHEL or Fedora

Install Grafana on RHEL or Fedora

This topic explains how to install Grafana dependencies, install Grafana on RHEL or Fedora, and start the Grafana server on your system.

You can install Grafana from the RPM repository, from standalone RPM, or with the binary .tar.gz file.

If you install via RPM or the .tar.gz file, then you must manually update Grafana for each new version.

Install Grafana from the RPM repository

If you install from the RPM repository, then Grafana is automatically updated every time you update your applications.

To install Grafana from the RPM repository, complete the following steps:

1. Import the GPG key:

   bash

   wget -q -O gpg.key https://rpm.grafana.com/gpg.key
   sudo rpm --import gpg.key

2. Create /etc/yum.repos.d/grafana.repo with the following content:

   bash

   [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

3. To prevent beta versions from being installed, add the following exclude line to your .repo file.

   bash

   exclude=*beta*

4. To install Grafana OSS, run the following command:

   bash

   sudo dnf install grafana

5. To install Grafana Enterprise, run the following command:

   bash

   sudo dnf install grafana-enterprise

Install the Grafana RPM package manually

If you install Grafana manually using YUM or RPM, then you must manually update Grafana for each new version. This method varies according to which Linux OS you are running.

Note: The RPM files are signed. You can verify the signature with this public GPG key.

1. On the Grafana download page, select the Grafana version you want to install.

   • The most recent Grafana version is selected by default.
   • The Version field displays only finished releases. If you want to install a beta version, click Nightly Builds and then select a version.

2. Select an Edition.

   • Enterprise - Recommended download. Functionally identical to the open source version, but includes features you can unlock with a license if you so choose.
   • Open Source - Functionally identical to the Enterprise version, but you will need to download the Enterprise version if you want Enterprise features.

3. Depending on which system you are running, click Linux or ARM.

4. Copy and paste the RPM package URL and the local RPM package information from the download page into the pattern shown below and run the command.

   bash

   sudo yum install -y <rpm package url>

Install Grafana as a standalone binary

Complete the following steps to install Grafana using the standalone binaries:

1. Navigate to the Grafana download page.
2. Select the Grafana version you want to install.
   • The most recent Grafana version is selected by default.
   • The Version field displays only tagged releases. If you want to install a nightly build, click Nightly Builds and then select a version.
3. Select an Edition.
   • Enterprise: This is the recommended version. It is functionally identical to the open-source version but includes features you can unlock with a license if you so choose.
   • Open Source: This version is functionally identical to the Enterprise version, but you will need to download the Enterprise version if you want Enterprise features.
4. Depending on which system you are running, click the Linux or ARM tab on the download page.
5. Copy and paste the code from the download page page into your command line and run.

Uninstall on RHEL or Fedora

To uninstall Grafana, run the following commands in a terminal window:

1. If you configured Grafana to run with systemd, stop the systemd service for Grafana server:

   shell

   sudo systemctl stop grafana-server

2. If you configured Grafana to run with init.d, stop the init.d service for Grafana server:

   shell

   sudo service grafana-server stop

3. To uninstall Grafana OSS:

   shell

   sudo dnf remove grafana

4. To uninstall Grafana Enterprise:

   shell

   sudo dnf remove grafana-enterprise

5. Optional: To remove the Grafana repository:

   shell

   sudo rm -i /etc/yum.repos.d/grafana.repo

Next steps

Refer to Start the Grafana server.