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

    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.

    You can run Grafana on your own hardware or use Grafana Cloud and get Grafana without the overhead of installing, maintaining, and scaling your observability stack. The free forever plan includes Grafana, 10K Prometheus series, 50 GB logs and more. .

    1. Download and install

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

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

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

    Choose if you want to install the Open Source or Enterprise edition of Grafana and enter the information from the edition you’ve chosen into grafana.repo. If you want to install the beta version of Grafana you need to replace the URL with a beta URL from the table above.

    For Enterprise releases:

    1. [grafana]
    2. name=grafana
    3. baseurl=https://packages.grafana.com/enterprise/rpm
    4. repo_gpgcheck=1
    5. enabled=1
    6. gpgcheck=1
    7. gpgkey=https://packages.grafana.com/gpg.key
    8. sslverify=1
    9. sslcacert=/etc/pki/tls/certs/ca-bundle.crt
    1. [grafana]
    3. repo_gpgcheck=1
    4. enabled=1
    5. gpgcheck=1
    6. gpgkey=https://packages.grafana.com/gpg.key
    7. sslverify=1
    8. sslcacert=/etc/pki/tls/certs/ca-bundle.crt

    Install Grafana with one of the following commands:

    1. sudo yum install grafana
    3. # or
    5. 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 , 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.

    You can also install Grafana using YUM directly:

    1. sudo yum install <rpm package url>

    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 .

    1. On the Grafana download page, select the Grafana version you want to install.
      • The most recent Grafana version is selected by default.
    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:

    1. sudo yum install initscripts urw-fonts wget
    2. wget <rpm package url>
    3. sudo rpm -Uvh <local rpm package>

    On OpenSUSE or SUSE:

    1. wget <rpm package url>
    2. 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.

    This starts the grafana-server process as the 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.

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

    1. sudo systemctl daemon-reload
    2. sudo systemctl start grafana-server
    3. sudo systemctl status grafana-server

    Configure the Grafana server to start at boot:

    1. sudo systemctl enable grafana-server

    Start the server with init.d

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

    1. sudo service grafana-server start
    2. sudo service grafana-server status

    Configure the Grafana server to start at boot:

    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:

    1. ./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

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

    Configure Grafana

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