2022-05-26 10:06:25 -05:00
---
aliases:
2022-12-09 10:36:04 -06:00
- ../../installation/debian/
- ../../installation/installation/debian/
2022-05-26 10:06:25 -05:00
description: Install guide for Grafana on Debian or Ubuntu
2023-03-22 12:41:17 -05:00
title: Install Grafana on Debian or Ubuntu
2023-06-19 10:27:40 -05:00
menuTitle: Debian or Ubuntu
2022-06-02 11:57:22 -05:00
weight: 100
2022-05-26 10:06:25 -05:00
---
2015-04-13 00:34:55 -05:00
2023-03-22 12:41:17 -05:00
# Install Grafana on Debian or Ubuntu
2015-04-13 00:34:55 -05:00
2023-03-22 12:41:17 -05:00
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.
2017-04-28 03:58:26 -05:00
2023-03-22 12:41:17 -05:00
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.
2022-11-08 06:10:56 -06:00
2023-05-22 15:45:28 -05:00
{{% 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 %}}
2022-11-08 06:10:56 -06:00
2023-03-22 12:41:17 -05:00
## Install from APT repository
2022-11-08 06:10:56 -06:00
2023-03-22 12:41:17 -05:00
If you install from the APT repository, Grafana automatically updates when you run `apt-get update` .
2018-04-20 06:23:45 -05:00
2022-11-08 06:10:56 -06:00
| 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` |
2015-08-12 09:30:48 -05:00
2023-05-22 15:45:28 -05:00
{{% 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 ](/products/enterprise/?utm_source=grafana-install-page ), which has support for [Enterprise plugins ](/grafana/plugins/?enterprise=1&utcm_source=grafana-install-page ).
{{% /admonition %}}
2020-01-24 09:33:59 -06:00
2023-03-22 12:41:17 -05:00
Complete the following steps to install Grafana from the APT repository:
2019-11-13 06:04:06 -06:00
2023-03-22 12:41:17 -05:00
1. To install required packages and download the Grafana repository signing key, run the following commands:
2020-01-24 09:33:59 -06:00
2023-03-22 12:41:17 -05:00
```bash
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
```
2020-01-24 09:33:59 -06:00
2023-03-22 12:41:17 -05:00
1. To add a repository for stable releases, run the following command:
2020-01-24 09:33:59 -06:00
2023-03-22 12:41:17 -05:00
```bash
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
```
2021-08-06 08:52:36 -05:00
2023-03-22 12:41:17 -05:00
1. To add a repository for beta releases, run the following command:
2020-07-09 09:25:10 -05:00
2023-03-22 12:41:17 -05:00
```bash
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
```
2020-07-09 09:25:10 -05:00
2023-06-23 12:20:20 -05:00
1. Run the following command to update the list of available packages:
2015-04-14 09:28:57 -05:00
2023-03-22 12:41:17 -05:00
```bash
# Update the list of available packages
sudo apt-get update
2023-06-23 12:20:20 -05:00
```
1. Run one of the following commands to install the OSS or Enterprise release:
2022-11-08 06:10:56 -06:00
2023-06-23 12:20:20 -05:00
```bash
# To install the latest OSS release:
2023-03-22 12:41:17 -05:00
sudo apt-get install grafana
2023-06-23 12:20:20 -05:00
```
2023-03-22 12:41:17 -05:00
2023-06-23 12:20:20 -05:00
```bash
# To install the latest Enterprise release:
2023-03-22 12:41:17 -05:00
sudo apt-get install grafana-enterprise
```
2020-07-09 09:25:10 -05:00
2023-03-22 12:41:17 -05:00
## Install Grafana using a deb package or as a standalone binary
2015-04-14 09:28:57 -05:00
2023-03-22 12:41:17 -05:00
If you choose not to install Grafana using APT, you can download and install Grafana using the deb package or as a standalone binary.
2015-04-14 09:28:57 -05:00
2023-03-22 12:41:17 -05:00
Complete the following steps to install Grafana using DEB or the standalone binaries:
2023-05-18 09:50:20 -05:00
1. Navigate to the [Grafana download page ](/grafana/download ).
2023-03-22 12:41:17 -05:00
1. Select the Grafana version you want to install.
2021-08-06 08:52:36 -05:00
- The most recent Grafana version is selected by default.
2023-03-22 12:41:17 -05:00
- The **Version** field displays only tagged releases. If you want to install a nightly build, click **Nightly Builds** and then select a version.
2020-01-10 11:38:54 -06:00
1. Select an **Edition** .
2023-03-22 12:41:17 -05:00
- **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.
2023-06-22 06:50:32 -05:00
1. Depending on which system you are running, click the **Linux** or **ARM** tab on the [download page ](/grafana/download ).
1. Copy and paste the code from the [download page ](/grafana/download ) into your command line and run.
2015-04-13 00:34:55 -05:00
2019-12-05 12:51:08 -06:00
## Next steps
2015-05-10 15:15:34 -05:00
2023-05-18 09:50:20 -05:00
- [Start the Grafana server ]({{< relref "../../start-restart-grafana" >}} )