Debian/Ubuntu Installation

Install Grafana on Debian or Ubuntu Linux using APT repository or DEB packages

Debian/Ubuntu Installation

This guide covers installing Grafana on Debian or Ubuntu Linux systems using the APT repository or standalone DEB packages.

Installation Methods

You can install Grafana on Debian/Ubuntu using:

• APT repository (recommended): Automatic updates via apt-get update
• DEB package: Manual installation from downloaded package
• Standalone binary: Manual installation from tarball

Install from APT Repository

Installing from the APT repository enables automatic updates when you run apt-get update.

Available Repositories

Edition	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

Grafana Enterprise is the recommended edition. It’s free and includes all OSS features, with the option to upgrade to the full Enterprise feature set.

Install from DEB Package

Manual installation using DEB packages requires you to manually update Grafana for each new version.

Install as Standalone Binary

For manual installation with full control over file locations:

Start Grafana Server

Using systemd

Start the Grafana server:

sudo systemctl start grafana-server

Enable Grafana to start at boot:

sudo systemctl enable grafana-server

Check service status:

sudo systemctl status grafana-server

Using init.d

Start Grafana:

sudo service grafana-server start

Enable at boot:

sudo update-rc.d grafana-server defaults

Configuration

After installation, Grafana uses these default paths:

Path	Description
/etc/grafana/grafana.ini	Configuration file
/var/lib/grafana	Data directory (SQLite database, plugins)
/var/log/grafana	Log files
/usr/share/grafana	Installation directory
/etc/grafana/provisioning	Provisioning directory
/etc/default/grafana-server	Environment variables

Environment Variables File

The systemd service reads environment variables from /etc/default/grafana-server:

CONF_FILE=/etc/grafana/grafana.ini
DATA_DIR=/var/lib/grafana
LOG_DIR=/var/log/grafana
PID_FILE_DIR=/run/grafana
PLUGINS_DIR=/var/lib/grafana/plugins
PROVISIONING_CFG_DIR=/etc/grafana/provisioning

Systemd Service Configuration

The Grafana systemd service includes security hardening:

• Runs as non-root grafana user (UID 472)
• Capability restrictions with CapabilityBoundingSet=
• Protected system directories
• Restricted system calls
• File open limit: 10,000
• Stop timeout: 20 seconds

Access Grafana

After starting the server, access Grafana:

1. Open your browser to http://localhost:3000
2. Sign in with default credentials:
   • Username: admin
   • Password: admin
3. Change the password when prompted

Uninstall Grafana

Troubleshooting

View logs

sudo journalctl -u grafana-server -f

Or check log files:

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

Check service status

sudo systemctl status grafana-server

Verify installation

grafana-server -v

Port already in use

If port 3000 is already in use, edit /etc/grafana/grafana.ini:

[server]
http_port = 3001

Restart Grafana:

sudo systemctl restart grafana-server

Next Steps

• Configure data sources
• Set up authentication (LDAP, OAuth, SAML)
• Configure SMTP for email notifications
• Set up provisioning for dashboards and data sources
• Configure an external database (MySQL or PostgreSQL)