This page explains how to install Grafana dependencies, download and install Grafana, get the service up and running on your Debian or Ubuntu system, and also describes the installation package details.
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]({{< relref "upgrading.md" >}}) for tips and guidance on updating an existing installation.
1. Download and install
You can install Grafana using our official APT repository, by downloading a .deb package, or by downloading a binary .tar.gz file.
Install from APT repository
If you install from the APT repository, then Grafana is automatically updated every time you run apt-get update.
Grafana Version
Package
Repository
Grafana OSS
grafana
https://packages.grafana.com/oss/deb stable main
Grafana OSS (Beta)
grafana
https://packages.grafana.com/oss/deb beta main
Grafana Enterprise
grafana-enterprise
https://packages.grafana.com/enterprise/deb stable main
Grafana Enterprise (Beta)
grafana-enterprise
https://packages.grafana.com/enterprise/deb beta main
We recommend all users install the Enterprise Edition of Grafana, which can be seamlessly upgraded with a Grafana Enterprise subscription.
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.
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.
Depending on which system you are running, click Linux or ARM.
Copy and paste the code from the installation page into your command line and run. It follows the pattern shown below.
Download the latest .tar.gz file and extract it. The files extract into a folder named after the Grafana version downloaded. This folder contains all files required to run Grafana. There are no init scripts or install scripts in this package.
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.
If you installed with the APT repository or .deb 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:
+++ title = "Install on Debian/Ubuntu" description = "Install guide for Grafana on Debian or Ubuntu" keywords = ["grafana", "installation", "documentation"] aliases = ["/docs/grafana/latest/installation/installation/debian"] weight = 200 +++
Install on Debian or Ubuntu
https://github.com/grafana/grafana/blob/main/docs/sources/installation/debian.md
This page explains how to install Grafana dependencies, download and install Grafana, get the service up and running on your Debian or Ubuntu system, and also describes the installation package details.
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]({{< relref "upgrading.md" >}}) for tips and guidance on updating an existing installation.
1. Download and install
You can install Grafana using our official APT repository, by downloading a
.deb
package, or by downloading a binary.tar.gz
file.Install from APT repository
If you install from the APT repository, then Grafana is automatically updated every time you run
apt-get update
.https://packages.grafana.com/oss/deb stable main
https://packages.grafana.com/oss/deb beta main
https://packages.grafana.com/enterprise/deb stable main
https://packages.grafana.com/enterprise/deb beta main
To install the latest Enterprise edition:
Add this repository for stable releases:
Add this repository if you want beta releases:
After you add the repository:
To install the latest OSS release:
Add this repository for stable releases:
Add this repository if you want beta releases:
After you add the repository:
Install .deb package
If you install the
.deb
package, then you will need to manually update Grafana for each new version.Install from binary .tar.gz file
Download the latest
.tar.gz
file and extract it. The files extract into a folder named after the Grafana version downloaded. This folder contains all files required to run Grafana. There are no init scripts or install scripts in this package.2. Start the server
This starts the
grafana-server
process as thegrafana
user, which was created during the package installation.If you installed with the APT repository or
.deb
package, then you can start the server usingsystemd
orinit.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:
Configure the Grafana server to start at boot:
Start the server with init.d
To start the service and verify that the service has started:
Configure the Grafana server to start at boot:
Execute the binary
The
grafana-server
binary .tar.gz needs the working directory to be the root install directory where the binary and thepublic
folder are located.Start Grafana by running:
Package details
/usr/sbin/grafana-server
/etc/init.d/grafana-server
/etc/default/grafana-server
/etc/grafana/grafana.ini
grafana-server.service
/var/log/grafana/grafana.log
/var/lib/grafana/grafana.db
/usr/share/grafana
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.