Install Grafana on Ubuntu 22.04/20.04/18.04

|
Last Updated:
|
|

In this guide, we are going to learn how to install Grafana on Ubuntu 22.04/20.04/18.04 servers. Grafana is the open source analytics & monitoring solution for every database.

Installing Grafana on Ubuntu 22.04/20.04/18.04

There exist different editions of Grafana. There is Grafana Enterprise and Grafana opensource (OSS).

We will be installing Grafana OSS version in this guide.

Grafana can be installed using the DEB binary or directly from the APT repository.

Run System Update

Before you can proceed to install Grafana, ensure that your system packages are up-to-date.

sudo apt update

Installing Grafana using DEB Package

To install Grafana using DEB binary package;

  • Navigate to  Grafana downloads page;
  • Select the current release version of Grafana
  • Select the edition, Enterprise or OSS (this guide installs OSS)
  • Copy the Grafana download and execute it on the system you are installing Grafana on;
wget https://dl.grafana.com/oss/release/grafana_9.4.7_amd64.deb

Once the download is done, verify the integrity of the downloaded package by calculating its checksum and comparing it to the one provided on the downloads page;

Update the version according to the current releases.

VER=9.4.7
sha256sum grafana_${VER}_amd64.deb 

Compare the resulting hash value with the value on the download’s page.

If all is well, proceed to install Grafana as shown below;

sudo apt install ./grafana_${VER}_amd64.deb
Reading package lists... Done
Building dependency tree... Done
Reading state information... Done
Note, selecting 'grafana' instead of './grafana_9.4.7_amd64.deb'
The following additional packages will be installed:
  fontconfig-config fonts-dejavu-core libfontconfig1
The following NEW packages will be installed:
  fontconfig-config fonts-dejavu-core grafana libfontconfig1
0 upgraded, 4 newly installed, 0 to remove and 79 not upgraded.
Need to get 1,202 kB/85.2 MB of archives.
After this operation, 312 MB of additional disk space will be used.
Do you want to continue? [Y/n] y

Installing Grafana from APT Repository

To install Grafana from APT repository;

  • Install Grafana OSS APT repository by running the command below;
sudo apt install software-properties-common curl gnupg2 -y
echo "deb https://packages.grafana.com/oss/deb stable main" | sudo tee  /etc/apt/sources.list.d/grafana.list
  • Install Grafana OSS APT repo GPG signing key.
curl -s https://packages.grafana.com/gpg.key | sudo gpg --dearmor > /etc/apt/trusted.gpg.d/grafana.gpg
  • After that, re-synchronize your system packages to the latest versions and install Grafana.
sudo apt update
sudo apt install grafana
  • Verify the installed version of Grafana.
apt show grafana
Package: grafana
Version: 9.4.7
Priority: optional
Section: default
Maintainer: [email protected]
Installed-Size: 309 MB
Depends: adduser, libfontconfig1
Homepage: https://grafana.com
License: AGPLv3
Vendor: Grafana
Download-Size: 84.0 MB
APT-Manual-Installed: yes
APT-Sources: https://packages.grafana.com/oss/deb stable/main amd64 Packages
Description: Grafana

Running Grafana on Ubuntu 22.04/20.04/18.04

Once the installation is done, reload systemd unit configuration files and start and enable Grafana to run on system boot.

sudo systemctl daemon-reload
sudo systemctl enable grafana-server --now

You can check the status;

systemctl status grafana-server
● grafana-server.service - Grafana instance
   Loaded: loaded (/usr/lib/systemd/system/grafana-server.service; enabled; vendor preset: enabled)
   Active: active (running) since Sun 2023-03-26 10:55:54 UTC; 11s ago
     Docs: http://docs.grafana.org
 Main PID: 5148 (grafana)
    Tasks: 5 (limit: 2314)
   CGroup: /system.slice/grafana-server.service
           └─5148 /usr/share/grafana/bin/grafana server --config=/etc/grafana/grafana.ini --pidfile=/run/grafana/grafana-server.pid --packaging=deb cfg:default.paths.logs=/

Mar 26 10:56:04 osboxes grafana[5148]: logger=migrator t=2023-03-26T10:56:04.694526782Z level=info msg="Executing migration" id="Add index for dashboard_id in dashboard_tag
Mar 26 10:56:04 osboxes grafana[5148]: logger=migrator t=2023-03-26T10:56:04.814790312Z level=info msg="Executing migration" id="Update dashboard table charset"
Mar 26 10:56:04 osboxes grafana[5148]: logger=migrator t=2023-03-26T10:56:04.969435137Z level=info msg="Executing migration" id="Update dashboard_tag table charset"
Mar 26 10:56:05 osboxes grafana[5148]: logger=migrator t=2023-03-26T10:56:05.101265042Z level=info msg="Executing migration" id="Add column folder_id in dashboard"
Mar 26 10:56:05 osboxes grafana[5148]: logger=migrator t=2023-03-26T10:56:05.244748848Z level=info msg="Executing migration" id="Add column isFolder in dashboard"
Mar 26 10:56:05 osboxes grafana[5148]: logger=migrator t=2023-03-26T10:56:05.387277739Z level=info msg="Executing migration" id="Add column has_acl in dashboard"
Mar 26 10:56:05 osboxes grafana[5148]: logger=migrator t=2023-03-26T10:56:05.530016602Z level=info msg="Executing migration" id="Add column uid in dashboard"
Mar 26 10:56:05 osboxes grafana[5148]: logger=migrator t=2023-03-26T10:56:05.672765618Z level=info msg="Executing migration" id="Update uid column values in dashboard"
Mar 26 10:56:05 osboxes grafana[5148]: logger=migrator t=2023-03-26T10:56:05.805234882Z level=info msg="Executing migration" id="Add unique index dashboard_org_id_uid"
Mar 26 10:56:05 osboxes grafana[5148]: logger=migrator t=2023-03-26T10:56:05.936297751Z level=info msg="Executing migration" id="Remove unique index org_id_slug"

You can check the logs on;

tail -f /var/log/grafana/grafana.log

Access Grafana UI

Grafana listens on TCP port 3000 by default;

ss -altnp | grep grafana
LISTEN   0         128                       *:3000                   *:*        users:(("grafana",pid=5148,fd=9))

To access Grafana UI, navigate to the browser and enter the address, http://localhost:3000.

To access Grafana from an externally, use the address, http://grafana-server-IP:3000.

However, for external access, you need to open TCP port 3000 on UFW if it is running.

sudo ufw allow 3000/tcp

If using iptables;

sudo iptables -I INPUT -p tcp -m tcp --dport 3000 -j ACCEPT

Login as admin for both username and password.

Install Grafana on Ubuntu

Once you login, you will be prompted to change the password.

You can choose to keep the default credentials and compromise the security of your Grafana or do change the password and proceed to Grafana dashboard.

grafana dashboard

On the left menu, you can explore more about Grafana.

grafana configuration menu

There you go. You have successfully installed Grafana on Ubuntu 22.04/20.04/18.04 server. Enjoy

See our other related guides by following the links below;

Install and Setup TIG Stack on Fedora 30

Install Elastic Stack 7 on Ubuntu 18.04/Debian 9.8

Install Graylog 3.0 on CentOS 7

SUPPORT US VIA A VIRTUAL CUP OF COFFEE

We're passionate about sharing our knowledge and experiences with you through our blog. If you appreciate our efforts, consider buying us a virtual coffee. Your support keeps us motivated and enables us to continually improve, ensuring that we can provide you with the best content possible. Thank you for being a coffee-fueled champion of our work!

Photo of author
koromicha
I am the Co-founder of Kifarunix.com, Linux and the whole FOSS enthusiast, Linux System Admin and a Blue Teamer who loves to share technological tips and hacks with others as a way of sharing knowledge as: "In vain have you acquired knowledge if you have not imparted it to others".

Leave a Comment