In this guide, we will provide step-by-step instructions on how to install Grafana on Debian 12. Grafana is a powerful open-source analytics and visualization platform that allows you to monitor and analyze your data in real-time. By following the installation process outlined below, you will be able to seamlessly set up Grafana on your Debian 12 system.
Table of Contents
Installing Grafana on Debian 12
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;
Download Grafana Binary Installer
- Navigate to Grafana downloads page;
- Select the current release version of Grafana
- Select the edition, Enterprise or OSS (this guide installs OSS)
- Execute the installer on the system you are installing Grafana on.
As of this writing, Grafana version 10.1.4.
Thus, replace the value of VER variable below with the current release version number;
VER=10.1.4wget https://dl.grafana.com/oss/release/grafana_${VER}_amd64.debVerify Integrity of the Grafana Binary Installer
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;
sha256sum grafana_${VER}_amd64.deb
Compare the resulting hash value with the value on the download’s page.
ENSURE the hash values match!
Install Grafana using DEB Binary on Debian 12
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_10.1.4_amd64.deb'
The following additional packages will be installed:
fontconfig-config fonts-dejavu-core libfontconfig1 musl
The following NEW packages will be installed:
fontconfig-config fonts-dejavu-core grafana libfontconfig1 musl
0 upgraded, 5 newly installed, 0 to remove and 8 not upgraded.
Need to get 2,174 kB/104 MB of archives.
After this operation, 380 MB of additional disk space will be used.
Do you want to continue? [Y/n] y
Get:1 http://deb.debian.org/debian bookworm/main amd64 fonts-dejavu-core all 2.37-6 [1,068 kB]
Get:2 http://deb.debian.org/debian bookworm/main amd64 fontconfig-config amd64 2.14.1-4 [315 kB]
Get:3 http://deb.debian.org/debian bookworm/main amd64 libfontconfig1 amd64 2.14.1-4 [386 kB]
Get:4 http://deb.debian.org/debian bookworm/main amd64 musl amd64 1.2.3-1 [406 kB]
Get:5 /root/grafana_10.1.4_amd64.deb grafana amd64 10.1.4 [102 MB]
Fetched 2,174 kB in 1s (3,305 kB/s)
Preconfiguring packages ...
Selecting previously unselected package fonts-dejavu-core.
(Reading database ... 36275 files and directories currently installed.)
Preparing to unpack .../fonts-dejavu-core_2.37-6_all.deb ...
Unpacking fonts-dejavu-core (2.37-6) ...
Selecting previously unselected package fontconfig-config.
Preparing to unpack .../fontconfig-config_2.14.1-4_amd64.deb ...
Unpacking fontconfig-config (2.14.1-4) ...
Selecting previously unselected package libfontconfig1:amd64.
Preparing to unpack .../libfontconfig1_2.14.1-4_amd64.deb ...
Unpacking libfontconfig1:amd64 (2.14.1-4) ...
Selecting previously unselected package musl:amd64.
Preparing to unpack .../musl_1.2.3-1_amd64.deb ...
Unpacking musl:amd64 (1.2.3-1) ...
Selecting previously unselected package grafana.
Preparing to unpack /root/grafana_10.1.4_amd64.deb ...
Unpacking grafana (10.1.4) ...
Setting up fonts-dejavu-core (2.37-6) ...
Setting up musl:amd64 (1.2.3-1) ...
Setting up fontconfig-config (2.14.1-4) ...
Setting up libfontconfig1:amd64 (2.14.1-4) ...
Setting up grafana (10.1.4) ...
Adding system user `grafana' (UID 102) ...
Adding new user `grafana' (UID 102) with group `grafana' ...
Not creating home directory `/usr/share/grafana'.
### NOT starting on installation, please execute the following statements to configure grafana to start automatically using systemd
sudo /bin/systemctl daemon-reload
sudo /bin/systemctl enable grafana-server
### You can start grafana-server by executing
sudo /bin/systemctl start grafana-server
Processing triggers for man-db (2.11.2-2) ...
Processing triggers for libc-bin (2.36-9+deb12u1) ...
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 -yecho "deb https://packages.grafana.com/oss/deb stable main" | sudo tee /etc/apt/sources.list.d/grafana.listInstall Grafana OSS APT repo GPG signing key.
curl -s https://packages.grafana.com/gpg.key | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/grafana.gpg
Install Grafana from APT Repository on Debian 12
After that, re-synchronize your system packages to the latest versions and install Grafana.
sudo apt update
sudo apt install grafana
Verify Grafana Installation
Verify the installed version of Grafana.
apt show grafana
Package: grafana
Version: 10.1.4
Priority: optional
Section: default
Maintainer: [email protected]
Installed-Size: 375 MB
Depends: adduser, libfontconfig1, musl
Homepage: https://grafana.com
License: AGPLv3
Vendor: "Grafana Labs"
Download-Size: 102 MB
APT-Manual-Installed: yes
APT-Sources: https://packages.grafana.com/oss/deb stable/main amd64 Packages
Description: Grafana
Running Grafana on Debian 12
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 (/lib/systemd/system/grafana-server.service; enabled; preset: enabled)
Active: active (running) since Wed 2023-10-04 12:49:42 EDT; 8min ago
Docs: http://docs.grafana.org
Main PID: 7738 (grafana)
Tasks: 13 (limit: 2304)
Memory: 105.3M
CPU: 6.723s
CGroup: /system.slice/grafana-server.service
└─7738 /usr/share/grafana/bin/grafana server --config=/etc/grafana/grafana.ini --pidfile=/run/grafana/grafana-server.pid --packaging=deb cfg:default.paths.logs=/var/log/grafana cfg:default.paths.da>
Oct 04 12:52:04 debian grafana[7738]: logger=modules t=2023-10-04T12:52:04.887098665-04:00 level=info msg="All modules healthy" modules="[provisioning background-services http-server secret-migrator]"
Oct 04 12:52:04 debian grafana[7738]: logger=ngalert.state.manager t=2023-10-04T12:52:04.887690829-04:00 level=info msg="Warming state cache for startup"
Oct 04 12:52:04 debian grafana[7738]: logger=ngalert.state.manager t=2023-10-04T12:52:04.888708392-04:00 level=info msg="State cache has been initialized" states=0 duration=1.01291ms
Oct 04 12:52:04 debian grafana[7738]: logger=ngalert.scheduler t=2023-10-04T12:52:04.889174027-04:00 level=info msg="Starting scheduler" tickInterval=10s
Oct 04 12:52:04 debian grafana[7738]: logger=ticker t=2023-10-04T12:52:04.889799448-04:00 level=info msg=starting first_tick=2023-10-04T12:52:10-04:00
Oct 04 12:52:04 debian grafana[7738]: logger=grafanaStorageLogger t=2023-10-04T12:52:04.895448725-04:00 level=info msg="storage starting"
Oct 04 12:52:04 debian grafana[7738]: logger=ngalert.multiorg.alertmanager t=2023-10-04T12:52:04.898749478-04:00 level=info msg="Starting MultiOrg Alertmanager"
Oct 04 12:52:05 debian grafana[7738]: logger=grafana.update.checker t=2023-10-04T12:52:05.816085002-04:00 level=info msg="Update check succeeded" duration=922.559943ms
Oct 04 12:52:05 debian grafana[7738]: logger=plugins.update.checker t=2023-10-04T12:52:05.834322446-04:00 level=info msg="Update check succeeded" duration=940.440361ms
Oct 04 12:53:38 debian grafana[7738]: logger=infra.usagestats t=2023-10-04T12:53:38.90452924-04:00 level=info msg="Usage stats are ready to report"
You can check the logs on;
tail -f /var/log/grafana/grafana.logAccess Grafana UI
Grafana listens on TCP port 3000 by default. It might take a few minutes for the service to fully come up.
ss -altnp | grep grafanaLISTEN 0 4096 *:3000 *:* users:(("grafana",pid=7738,fd=11))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 ACCEPTLogin as admin for both username and password.
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.
Naviagate through Grafana Menu
On the left menu, you can explore more about Grafana.
There you go. You have successfully installed Grafana on Debian 12 server. Enjoy
See our other related guides by following the links below;
Install and Setup TIG Stack on Fedora 30
