2015-04-13 13:34:55 +08:00
|
|
|
---
|
|
|
|
|
page_title: Installing on Debian / Ubuntu
|
|
|
|
|
page_description: Grafana Installation guide for Debian / Ubuntu.
|
|
|
|
|
page_keywords: grafana, installation, debian, ubuntu, guide
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
# Installing on Debian / Ubuntu
|
|
|
|
|
|
|
|
|
|
## Download
|
|
|
|
|
|
|
|
|
|
Description | Download
|
|
|
|
|
------------ | -------------
|
|
|
|
|
.deb for Debian-based Linux | [grafana_2.0.0-beta3_amd64.deb](https://grafanarel.s3.amazonaws.com/builds/grafana_2.0.0-beta3_amd64.deb)
|
|
|
|
|
|
|
|
|
|
## Install
|
|
|
|
|
|
|
|
|
|
$ wget https://grafanarel.s3.amazonaws.com/builds/grafana_2.0.0-beta3_amd64.deb
|
|
|
|
|
$ sudo apt-get install -y adduser libfontconfig
|
2015-04-13 14:14:13 +08:00
|
|
|
$ sudo dpkg -i grafana_2.0.0-beta3_amd64.deb
|
2015-04-13 13:34:55 +08:00
|
|
|
|
|
|
|
|
## Package details
|
|
|
|
|
|
|
|
|
|
- Installs binary to `/usr/sbin/grafana-server`
|
|
|
|
|
- Init.d script to `/etc/init.d/grafana-server`
|
|
|
|
|
- Default file (environment vars) to `/etc/default/grafana-server`
|
|
|
|
|
- Configuration file to `/etc/grafana/grafana.ini`
|
|
|
|
|
- Systemd service (if systemd is available) name `grafana-server.service`
|
|
|
|
|
- The default configuration specifies log file at `/var/log/grafana/grafana.log`
|
|
|
|
|
- The default configuration specifies sqlite3 db at `/var/lib/grafana/grafana.db`
|
|
|
|
|
|
|
|
|
|
## Start the server (init.d service)
|
|
|
|
|
|
|
|
|
|
- Start grafana by `sudo service grafana-server start`
|
|
|
|
|
- This will start the grafana-server process as the `grafana` user (created during package install)
|
|
|
|
|
- Default http port is `3000`, and default user is admin/admin
|
|
|
|
|
|
2015-04-13 14:14:13 +08:00
|
|
|
To configure Grafana server to start at boot time:
|
|
|
|
|
|
|
|
|
|
$ sudo update-rc.d grafana-server defaults 95 10
|
2015-04-13 13:34:55 +08:00
|
|
|
|
2015-04-13 14:14:13 +08:00
|
|
|
## Start the server (via systemd)
|
2015-04-13 13:34:55 +08:00
|
|
|
$ systemctl daemon-reload
|
|
|
|
|
$ systemctl start grafana-server
|
|
|
|
|
$ systemctl status grafana-server
|
|
|
|
|
|
2015-04-13 14:14:13 +08:00
|
|
|
Enable the systemd service (so grafana starts at boot)
|
|
|
|
|
|
|
|
|
|
sudo systemctl enable grafana-server.service
|
|
|
|
|
|
2015-04-13 13:34:55 +08:00
|
|
|
## Environment file
|
|
|
|
|
|
|
|
|
|
The systemd service file and init.d script both use the file located at `/etc/default/grafana-server` for
|
|
|
|
|
environment variables used when starting the backend. Here you can override log directory, data directory and other
|
|
|
|
|
variables.
|
|
|
|
|
|
|
|
|
|
### Logging
|
|
|
|
|
|
2015-04-13 14:14:13 +08:00
|
|
|
By default grafana will log to `/var/log/grafana`
|
|
|
|
|
|
|
|
|
|
### Database
|
|
|
|
|
|
|
|
|
|
The default configuration specifies a sqlite3 database located at `/var/lib/grafana/grafana.db`. Please backup
|
|
|
|
|
this database before upgrades. You can also use mysql or postgres as the Grafana database.
|
2015-04-13 13:34:55 +08:00
|
|
|
|
|
|
|
|
## Configuration
|
|
|
|
|
|
|
|
|
|
The configuration file is located at `/etc/grafana/grafana.ini`. Go the [Configuration](configuration) page for details
|
|
|
|
|
on all those options.
|
|
|
|
|
|
|
|
|
|
### Adding data sources
|
|
|
|
|
|
|
|
|
|
- [Graphite](../datasources/graphite.md)
|
|
|
|
|
- [InfluxDB](../datasources/influxdb.md)
|
|
|
|
|
- [OpenTSDB](../datasources/opentsdb.md)
|
|
|
|
|
|
2015-04-13 13:55:07 +08:00
|
|
|
## Installing from binary tar file
|
|
|
|
|
|
|
|
|
|
Start by [downloading](http://grafana.org/download/builds) the latest `.tar.gz` file and extract it.
|
|
|
|
|
This will extract into a folder named after the version you downloaded. This folder contains all files required to run grafana.
|
|
|
|
|
There are no init scripts or install scripts in this package.
|
|
|
|
|
|
|
|
|
|
To configure grafana add a config file named `custom.ini` to the `conf` folder and override any of the settings defined in
|
|
|
|
|
`conf/defaults.ini`. Start grafana by excecuting `./grafana web`. The grafana binary needs the working directory
|
|
|
|
|
to be the root install dir (where the binary is and the public folder is located).
|
|
|
|
|
|
|
|
|
|
|
