# Install Grafana

## Grafana

Grafana provides all dashboard functionality. Dashboards are displayed using Grafana's user interface, and query for data from Prometheus.

### Install Supporting Software

Install the supporting software we may need.

```bash
sudo apt-get update
sudo apt-get install apt-transport-https
sudo apt-get install software-properties-common wget
```

### Install Grafana

Install the key for authenticating Grafana packages.

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

This command may generate a warning about `apt-key` being deprecated. That is not a problem.

<figure><img src="https://971382438-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZON6xeJcH6NDhbzjDAWf%2Fuploads%2Fgit-blob-22771e2963d015596107a2844ceb0231c4a469f9%2Fgrafana-apt-get.png?alt=media" alt=""><figcaption><p>Results of <code>wget | apt-key</code> command</p></figcaption></figure>

Add the Grafana repository to the list of external repositories and update the package list.

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

The `add-apt-repository` command may also generate a warning about `apt-key` being deprecated.

<figure><img src="https://971382438-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZON6xeJcH6NDhbzjDAWf%2Fuploads%2Fgit-blob-4bcd3a3da5131062dd9c60c15dd5964baddcc619%2Fgrafana-add-apt-repository.png?alt=media" alt=""><figcaption><p>Results of <code>add-apt-repository</code> command</p></figcaption></figure>

Update the package list and install Grafana.

```bash
sudo apt-get update
sudo apt-get install grafana
```

<figure><img src="https://971382438-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZON6xeJcH6NDhbzjDAWf%2Fuploads%2Fgit-blob-6e4ab58d44049fd12fa9e243b9c3398308b72f67%2Finstall-grafana.png?alt=media" alt=""><figcaption><p>Results of <code>sudo apt-get install grafana</code> command</p></figcaption></figure>

### Notes

{% hint style="info" %}
Grafana will listen on port 3000. This is the port for the Grafana user interface.
{% endhint %}

{% hint style="warning" %}
We have not yet configured nor started Grafana.
{% endhint %}