mirror of https://github.com/grafana/grafana.git synced 2025-02-16 18:34:52 -06:00

Docs: Fixed broken links in Basic Concepts (#21035 )

* Fixed broken links

* Update basic_concepts.md

* Fix REF_NOT_FOUND errors

* add shortcode

Co-authored-by: Robby Milo <robbymilo@gmail.com>

2019-12-30 08:04:02 -08:00

4.9 KiB

Raw Blame History

+++ title = "Install on Debian/Ubuntu" description = "Install guide for Grafana on Debian or Ubuntu" keywords = ["grafana", "installation", "documentation"] type = "docs" aliases = ["/docs/grafana/latest/installation/installation/debian"] [menu.docs] name = "Install on Ubuntu/Debian" identifier = "debian" parent = "installation" weight = 200 +++

Install on Debian or Ubuntu

This page explains how to install Grafana dependencies, download and install Grafana, get the service up and running on your system, and the 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

We recommend that you run all the listed commands before you download and install Grafana. They might not be necessary on all systems, but if you run them first then you will not be interrupted by dependency errors.

You can install Grafana using our official APT repository, by downloading a .deb package, or by using a binary .tar.gz file.

Install from APT repository

On some older versions of Ubuntu and Debian you may need to install the apt-transport-https package which is needed to fetch packages over HTTPS.

sudo apt-get install -y apt-transport-https

Install any missing dependencies:

sudo apt-get install -y software-properties-common wget

Add our GPG key to install signed packages:

wget -q -O - https://packages.grafana.com/gpg.key | sudo apt-key add -

Add this repository for stable releases:

sudo add-apt-repository "deb https://packages.grafana.com/oss/deb stable main"

Add this repository if you want beta releases:

sudo add-apt-repository "deb https://packages.grafana.com/oss/deb beta main"

Update your APT repositories and install Grafana:

sudo apt-get update
sudo apt-get install grafana

Install .deb package

Go to the Linux download page for the latest download links.

If you use ARM, then use the ARM download page for the latest download links.

sudo wget <.deb package url>
sudo apt-get install -y adduser libfontconfig1
sudo dpkg -i grafana_<version>_amd64.deb

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 that you downloaded. This folder contains all files required to run Grafana. There are no init scripts or install scripts in this package.

sudo wget <tar.gz package url>
sudo apt-get install -y adduser libfontconfig1
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 using systemd:

sudo systemctl daemon-reload
sudo systemctl start grafana-server

Verify that the service has started:

sudo systemctl status grafana-server

Enable the systemd service so that Grafana starts at boot:

sudo systemctl enable grafana-server.service

Start the server with init.d

Start Grafana by running:

sudo service grafana-server start

Verify that the service has started:

sudo service grafana-server status

Configure the Grafana server to start at boot:

sudo update-rc.d grafana-server defaults

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.