Important: This documentation is about an older version. It's relevant only to the release noted, many of the features and functions have been updated or replaced. Please view the current version.

Documentation Grafana documentation Setup Install Grafana Install on RPM-based Linux

Install on RPM-based Linux (CentOS, Fedora, OpenSuse, Red Hat)

This topic explains how to install Grafana dependencies, download and install Grafana, get the service up and running on your RPM-based Linux system, and the installation package details.

Repository migration (November 8th 2022)

From that date, Grafana packages will be served from a new repository (<packages.grafana.com/rpm/{product}> -> <rpm.grafana.com>). The new repository serves, from a single YUM/DNF configuration, all Grafana OSS products, as well as Grafana Enterprise.

The old URLs will still work, serving the content from the new repository, but you may encounter warnings about some repository attributes changing.

Note on upgrading

While the process for upgrading Grafana is very similar to installing Grafana, there are some key backup steps you should perform. Read Upgrading Grafana for tips and guidance on updating an existing installation.

1. Download and install

You can install Grafana from a YUM repository, manually using YUM, manually using RPM, or by downloading a binary .tar.gz file.

Install from YUM repository

If you install from the YUM repository, then Grafana is automatically updated every time you run sudo yum update.

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 and has support for Enterprise plugins.

Add a new file to your YUM repo using the method of your choice. The command below uses nano.

bash Copy

sudo nano /etc/yum.repos.d/grafana.repo

bash Copy

[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

Optionally, add an exclude line to your .repo file to prevent beta versions from being installed.

bash Copy

exclude=*beta*

Install Grafana with one of the following commands

We recommend all users to install the Enterprise Edition of Grafana, which can be seamlessly upgraded with a Grafana Enterprise subscription.

bash Copy

sudo yum install grafana

# or

sudo yum install grafana-enterprise

Install manually with YUM

If you install manually with YUM, then you will need to manually update Grafana for each new version. To enable automatic updates for your Grafana installation please use the instructions below to install via our YUM repository.

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 code from the installation page into your command line and run. It follows the pattern shown below.

bash Copy

wget <rpm package url>
sudo yum localinstall <local rpm package>

You can also install Grafana using YUM directly:

bash Copy

sudo yum install <rpm package url>

Install with RPM

If you install with RPM, then you will need to manually update Grafana for each new version. This method varies according to which Linux OS you are running. Read the instructions fully before you begin.

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 installation page into the pattern shown below, then run the commands.

On CentOS, Fedora, Red Hat, or RHEL:

bash Copy

sudo yum install initscripts urw-fonts wget
wget <rpm package url>
sudo rpm -Uvh <local rpm package>

On OpenSUSE or SUSE:

bash Copy

wget <rpm package url>
sudo rpm -i --nodeps <local rpm package>

Install from binary .tar.gz file

Download the latest .tar.gz file and extract it. The files are extracted into a folder named after the Grafana version that you downloaded. This folder contains all files required to run Grafana. There are no init scripts or install scripts in this package.

bash Copy

wget <tar.gz package url>
sudo tar -zxvf <tar.gz package>

2. Start the server

This starts the grafana-server process as the grafana user, which was created during the package installation. The systemd commands work in most cases, but some older Linux systems might require init.d. The installer should prompt you with the correct commands.

If you installed with an .rpm package, then you can start the server using systemd or init.d. If you installed a binary .tar.gz file, then you need to execute the binary.

Start the server with systemd

To start the service and verify that the service has started:

bash Copy

sudo systemctl daemon-reload
sudo systemctl start grafana-server
sudo systemctl status grafana-server

Configure the Grafana server to start at boot:

bash Copy

sudo systemctl enable grafana-server

SUSE or OpenSUSE users: You might need to start the server with the systemd method, then use the init.d method to configure Grafana to start at boot.

Serving Grafana on a port < 1024

If you are using systemd and want to start Grafana on a port that is less than 1024, then you must add a systemd unit override.

1. The following command creates an override file in your configured editor:

bash Copy

# Alternatively, create a file in /etc/systemd/system/grafana-server.service.d/override.conf
systemctl edit grafana-server.service

1 Add these additional settings to grant the CAP_NET_BIND_SERVICE capability. To read more about capabilities, see the manual page on capabilities.

Copy

[Service]
# Give the CAP_NET_BIND_SERVICE capability
CapabilityBoundingSet=CAP_NET_BIND_SERVICE
AmbientCapabilities=CAP_NET_BIND_SERVICE

# A private user cannot have process capabilities on the host's user
# namespace and thus CAP_NET_BIND_SERVICE has no effect.
PrivateUsers=false

Serving Grafana behind a proxy

When serving Grafana behind a proxy, you need to configure the http_proxy and https_proxy environment variables.

Centos 6

If you are on Centos 6, add the following lines to the /etc/sysconfig/grafana-server file.

Copy

export no_proxy=internal.domain,127.0.0.1
export http_proxy=http://proxy.domain:3128/
export https_proxy=http://proxy.domain:3128/

Centos 7

If you are on Centos 7, add the following lines to the /etc/sysconfig/grafana-server file.

Copy

http_proxy=http://proxy.domain:3128/
https_proxy=http://proxy.domain:3128/
no_proxy=internal.domain,127.0.0.1

Start the server with init.d

To start the service and verify that the service has started:

bash Copy

sudo service grafana-server start
sudo service grafana-server status

Configure the Grafana server to start at boot:

bash Copy

sudo /sbin/chkconfig --add grafana-server

Execute the binary

The grafana-server binary needs the working directory to be the root install directory where the binary and the public folder are located.

Start Grafana by running:

bash Copy

./bin/grafana-server web

Package details

• Installs binary to /usr/sbin/grafana-server
• Copies init.d script to /etc/init.d/grafana-server
• Installs default file (environment vars) to /etc/sysconfig/grafana-server
• Copies configuration file to /etc/grafana/grafana.ini
• Installs systemd service (if systemd is available) name grafana-server.service
• The default configuration uses a log file at /var/log/grafana/grafana.log
• The default configuration specifies an sqlite3 database at /var/lib/grafana/grafana.db

Next steps

Refer to the Getting Started guide for information about logging in, setting up data sources, and so on.

Configure Grafana

Refer to the Configuration page for details on options for customizing your environment, logging, database, and so on.