grafana/docs/sources/setup-grafana/installation/debian/index.md

aliases	description	labels	menuTitle	title	weight
../../installation/debian/ ../../installation/installation/debian/	Install guide for Grafana on Debian or Ubuntu	products enterprise oss	Debian or Ubuntu	Install Grafana on Debian or Ubuntu	100

Install Grafana on Debian or Ubuntu

This topic explains how to install Grafana dependencies, install Grafana on Linux Debian or Ubuntu, and start the Grafana server on your Debian or Ubuntu system.

There are multiple ways to install Grafana: using the Grafana Labs APT repository, by downloading a .deb package, or by downloading a binary .tar.gz file. Choose only one of the methods below that best suits your needs.

{{% admonition type="note" %}} If you install via the .deb package or .tar.gz file, then you must manually update Grafana for each new version. {{% /admonition %}}

Install from APT repository

If you install from the APT repository, Grafana automatically updates when you run apt-get update.

Grafana Version	Package	Repository
Grafana Enterprise	grafana-enterprise	https://apt.grafana.com stable main
Grafana Enterprise (Beta)	grafana-enterprise	https://apt.grafana.com beta main
Grafana OSS	grafana	https://apt.grafana.com stable main
Grafana OSS (Beta)	grafana	https://apt.grafana.com beta main

{{% 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, which has support for Enterprise plugins. {{% /admonition %}}

Complete the following steps to install Grafana from the APT repository:

1. To install required packages and download the Grafana repository signing key, run the following commands:

   sudo apt-get install -y apt-transport-https
   sudo apt-get install -y software-properties-common wget
   sudo wget -q -O /usr/share/keyrings/grafana.key https://apt.grafana.com/gpg.key
   

2. To add a repository for stable releases, run the following command:

   echo "deb [signed-by=/usr/share/keyrings/grafana.key] https://apt.grafana.com stable main" | sudo tee -a /etc/apt/sources.list.d/grafana.list
   

3. To add a repository for beta releases, run the following command:

   echo "deb [signed-by=/usr/share/keyrings/grafana.key] https://apt.grafana.com beta main" | sudo tee -a /etc/apt/sources.list.d/grafana.list
   

4. Run the following command to update the list of available packages:

   # Updates the list of available packages
   sudo apt-get update
   

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

   # Installs the latest OSS release:
   sudo apt-get install grafana
   

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

   # Installs the latest Enterprise release:
   sudo apt-get install grafana-enterprise
   

Install Grafana using a deb package or as a standalone binary

If you choose not to install Grafana using APT, you can download and install Grafana using the deb package or as a standalone binary.

Complete the following steps to install Grafana using DEB or 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 into your command line and run.

Uninstall on Debian or Ubuntu

Complete any of the following steps to uninstall Grafana.

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

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

   sudo systemctl stop grafana-server
   

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

   sudo service grafana-server stop
   

3. To uninstall Grafana OSS:

   sudo apt-get remove grafana
   

4. To uninstall Grafana Enterprise:

   sudo apt-get remove grafana-enterprise
   

5. Optional: To remove the Grafana repository:

   sudo rm -i /etc/apt/sources.list.d/grafana.list
   

Next steps

• [Start the Grafana server]({{< relref "../../start-restart-grafana" >}})