2023-04-07 08:44:01 -05:00
---
2023-06-23 12:41:06 -05:00
description: Install guide for Grafana on RHEL and Fedora.
Explicitly set all front matter labels in the source files (#71548)
* Set every page to have defaults of 'Enterprise' and 'Open source' labels
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
* Set administration pages to have of 'Cloud', 'Enterprise', and 'Open source' labels
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
* Set administration/enterprise-licensing pages to have 'Enterprise' labels
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
* Set administration/organization-management pages to have 'Enterprise' and 'Open source' labels
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
* Set administration/provisioning pages to have 'Enterprise' and 'Open source' labels
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
* Set administration/recorded-queries pages to have labels cloud,enterprise
* Set administration/roles-and-permissions/access-control pages to have labels cloud,enterprise
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
* Set administration/stats-and-license pages to have labels cloud,enterprise
* Set alerting pages to have labels cloud,enterprise,oss
* Set breaking-changes pages to have labels cloud,enterprise,oss
* Set dashboards pages to have labels cloud,enterprise,oss
* Set datasources pages to have labels cloud,enterprise,oss
* Set explore pages to have labels cloud,enterprise,oss
* Set fundamentals pages to have labels cloud,enterprise,oss
* Set introduction/grafana-cloud pages to have labels cloud
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
* Fix introduction pages products
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
* Set panels-visualizations pages to have labels cloud,enterprise,oss
* Set release-notes pages to have labels cloud,enterprise,oss
* Set search pages to have labels cloud,enterprise,oss
* Set setup-grafana/configure-security/audit-grafana pages to have labels cloud,enterprise
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
* Set setup-grafana/configure-security/configure-authentication pages to have labels cloud,enterprise,oss
* Set setup-grafana/configure-security/configure-authentication/enhanced-ldap pages to have labels cloud,enterprise
* Set setup-grafana/configure-security/configure-authentication/saml pages to have labels cloud,enterprise
* Set setup-grafana/configure-security/configure-database-encryption/encrypt-secrets-using-hashicorp-key-vault pages to have labels cloud,enterprise
* Set setup-grafana/configure-security/configure-request-security pages to have labels cloud,enterprise,oss
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
* Set setup-grafana/configure-security/configure-team-sync pages to have labels cloud,enterprise
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
* Set setup-grafana/configure-security/export-logs pages to have labels cloud,enterprise
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
* Set troubleshooting pages to have labels cloud,enterprise,oss
* Set whatsnew pages to have labels cloud,enterprise,oss
* Apply updated labels from review
Co-authored-by: brendamuir <100768211+brendamuir@users.noreply.github.com>
Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com>
---------
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
Co-authored-by: brendamuir <100768211+brendamuir@users.noreply.github.com>
Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com>
2023-07-18 03:10:12 -05:00
labels:
products:
- enterprise
- oss
2023-06-23 12:41:06 -05:00
menuTitle: RHEL or Fedora
Explicitly set all front matter labels in the source files (#71548)
* Set every page to have defaults of 'Enterprise' and 'Open source' labels
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
* Set administration pages to have of 'Cloud', 'Enterprise', and 'Open source' labels
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
* Set administration/enterprise-licensing pages to have 'Enterprise' labels
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
* Set administration/organization-management pages to have 'Enterprise' and 'Open source' labels
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
* Set administration/provisioning pages to have 'Enterprise' and 'Open source' labels
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
* Set administration/recorded-queries pages to have labels cloud,enterprise
* Set administration/roles-and-permissions/access-control pages to have labels cloud,enterprise
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
* Set administration/stats-and-license pages to have labels cloud,enterprise
* Set alerting pages to have labels cloud,enterprise,oss
* Set breaking-changes pages to have labels cloud,enterprise,oss
* Set dashboards pages to have labels cloud,enterprise,oss
* Set datasources pages to have labels cloud,enterprise,oss
* Set explore pages to have labels cloud,enterprise,oss
* Set fundamentals pages to have labels cloud,enterprise,oss
* Set introduction/grafana-cloud pages to have labels cloud
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
* Fix introduction pages products
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
* Set panels-visualizations pages to have labels cloud,enterprise,oss
* Set release-notes pages to have labels cloud,enterprise,oss
* Set search pages to have labels cloud,enterprise,oss
* Set setup-grafana/configure-security/audit-grafana pages to have labels cloud,enterprise
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
* Set setup-grafana/configure-security/configure-authentication pages to have labels cloud,enterprise,oss
* Set setup-grafana/configure-security/configure-authentication/enhanced-ldap pages to have labels cloud,enterprise
* Set setup-grafana/configure-security/configure-authentication/saml pages to have labels cloud,enterprise
* Set setup-grafana/configure-security/configure-database-encryption/encrypt-secrets-using-hashicorp-key-vault pages to have labels cloud,enterprise
* Set setup-grafana/configure-security/configure-request-security pages to have labels cloud,enterprise,oss
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
* Set setup-grafana/configure-security/configure-team-sync pages to have labels cloud,enterprise
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
* Set setup-grafana/configure-security/export-logs pages to have labels cloud,enterprise
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
* Set troubleshooting pages to have labels cloud,enterprise,oss
* Set whatsnew pages to have labels cloud,enterprise,oss
* Apply updated labels from review
Co-authored-by: brendamuir <100768211+brendamuir@users.noreply.github.com>
Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com>
---------
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
Co-authored-by: brendamuir <100768211+brendamuir@users.noreply.github.com>
Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com>
2023-07-18 03:10:12 -05:00
title: Install Grafana on RHEL or Fedora
2023-06-19 10:27:40 -05:00
weight: 200
2023-04-07 08:44:01 -05:00
---
2023-06-23 12:41:06 -05:00
# Install Grafana on RHEL or Fedora
2023-04-07 08:44:01 -05:00
2023-06-23 12:41:06 -05:00
This topic explains how to install Grafana dependencies, install Grafana on RHEL or Fedora, and start the Grafana server on your system.
2023-04-07 08:44:01 -05:00
2023-06-23 14:31:11 -05:00
You can install Grafana from the RPM repository, from standalone RPM, or with the binary `.tar.gz` file.
2023-04-07 08:44:01 -05:00
If you install via RPM or the `.tar.gz` file, then you must manually update Grafana for each new version.
2023-06-23 14:31:11 -05:00
## Install Grafana from the RPM repository
2023-04-07 08:44:01 -05:00
2023-06-23 14:31:11 -05:00
If you install from the RPM repository, then Grafana is automatically updated every time you update your applications.
2023-04-07 08:44:01 -05:00
| Grafana Version | Package | Repository |
| ------------------ | ------------------ | ------------------------- |
| Grafana Enterprise | grafana-enterprise | `https://rpm.grafana.com` |
| Grafana OSS | grafana | `https://rpm.grafana.com` |
2023-05-22 15:45:28 -05:00
{{% admonition type="note" %}}
Grafana Enterprise is the recommended and default edition. It is available for free and includes all the features of the OSS edition. You can also upgrade to the [full Enterprise feature set ](/products/enterprise/?utm_source=grafana-install-page ), which has support for [Enterprise plugins ](/grafana/plugins/?enterprise=1&utcm_source=grafana-install-page ).
{{% /admonition %}}
2023-04-07 08:44:01 -05:00
2023-06-23 14:31:11 -05:00
To install Grafana from the RPM repository, complete the following steps:
2023-04-07 08:44:01 -05:00
2023-06-23 12:41:06 -05:00
1. Import the GPG key:
```bash
wget -q -O gpg.key https://rpm.grafana.com/gpg.key
sudo rpm --import gpg.key
```
2023-06-23 14:31:11 -05:00
1. Create `/etc/yum.repos.d/grafana.repo` with the following content:
2023-04-07 08:44:01 -05:00
```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
```
1. To prevent beta versions from being installed, add the following exclude line to your `.repo` file.
```bash
exclude=*beta*
```
1. To install Grafana OSS, run the following command:
```bash
2023-06-23 14:31:11 -05:00
sudo dnf install grafana
2023-04-07 08:44:01 -05:00
```
1. To install Grafana Enterprise, run the following command:
```bash
2023-06-23 14:31:11 -05:00
sudo dnf install grafana-enterprise
2023-04-07 08:44:01 -05:00
```
## 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 ](https://rpm.grafana.com/gpg.key ).
2023-05-18 09:50:20 -05:00
1. On the [Grafana download page ](/grafana/download ), select the Grafana version you want to install.
2023-04-07 08:44:01 -05:00
- 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.
1. 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.
1. Depending on which system you are running, click **Linux** or **ARM** .
2023-06-22 06:50:32 -05:00
1. Copy and paste the RPM package URL and the local RPM package information from the [download page ](/grafana/download ) into the pattern shown below and run the command.
2023-04-07 08:44:01 -05:00
```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:
2023-05-18 09:50:20 -05:00
1. Navigate to the [Grafana download page ](/grafana/download ).
2023-04-07 08:44:01 -05:00
1. 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.
1. 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.
2023-06-23 12:41:06 -05:00
1. Depending on which system you are running, click the **Linux** or **ARM** tab on the [download page ](/grafana/download ).
1. Copy and paste the code from the [download page ](/grafana/download ) page into your command line and run.
2023-04-07 08:44:01 -05:00
2023-07-05 08:06:03 -05:00
## 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
```
1. If you configured Grafana to run with init.d, stop the init.d service for Grafana server:
```shell
sudo service grafana-server stop
```
1. To uninstall Grafana OSS:
```shell
sudo dnf remove grafana
```
1. To uninstall Grafana Enterprise:
```shell
sudo dnf remove grafana-enterprise
```
1. Optional: To remove the Grafana repository:
```shell
2023-08-28 09:24:54 -05:00
sudo rm -i /etc/yum.repos.d/grafana.repo
2023-07-05 08:06:03 -05:00
```
2023-04-07 08:44:01 -05:00
## Next steps
2023-05-18 09:50:20 -05:00
Refer to [Start the Grafana server ]({{< relref "../../start-restart-grafana" >}} ).