mirror of
https://github.com/grafana/grafana.git
synced 2025-07-29 19:42:49 +08:00
96008c9738
commit 4113ed00782590187d19dd2f8cbae683f164142c
Author: Torkel Ödegaard <torkel.odegaard@gmail.com>
Date: Fri Oct 21 10:47:35 2016 +0200
docs(): minor fix for docs index page
commit 45478d120571519462fac905aadeab5954696690
Author: Torkel Ödegaard <torkel.odegaard@gmail.com>
Date: Thu Oct 20 14:28:21 2016 +0200
updated
commit c9c1c1d5a462f85e8001a45218f24102583d7aee
Author: Torkel Ödegaard <torkel.odegaard@gmail.com>
Date: Thu Oct 20 14:27:34 2016 +0200
docs(): updated image refs
commit 5fa0f27963968d77bbbbb7edd973847ea72135e3
Author: Torkel Ödegaard <torkel.odegaard@gmail.com>
Date: Wed Oct 19 14:33:04 2016 +0200
docs is almost done
commit 6b988c90cb08563e2c27212338c2947e69f6fcc3
Author: Torkel Ödegaard <torkel.odegaard@gmail.com>
Date: Tue Oct 18 20:45:28 2016 +0200
almost done
commit 17757c21ed813892ddb1f289f2e52613caf7bcef
Author: Torkel Ödegaard <torkel@grafana.org>
Date: Tue Oct 18 16:45:48 2016 +0200
making progress on docs
commit f06c815991dd81b8893912a6da04a17b80b63fda
Author: Torkel Ödegaard <torkel.odegaard@gmail.com>
Date: Tue Oct 18 14:30:55 2016 +0200
progress on new docs
commit 5197237426252623de2d8b9cc22ddbbdbb240763
Author: Torkel Ödegaard <torkel.odegaard@gmail.com>
Date: Tue Oct 18 13:25:26 2016 +0200
making progress
commit 33e2b6b617f16f65878141cf11e54b2817a2ea96
Merge: de385e5 ecb4a99
Author: Torkel Ödegaard <torkel.odegaard@gmail.com>
Date: Tue Oct 18 12:17:58 2016 +0200
Merge branch 'new-docs' of github.com:grafana/grafana into new-docs
commit ecb4a99dd54aa39f17d9bf4d7e132a389812f8fd
Author: Torkel Ödegaard <torkel@grafana.org>
Date: Tue Oct 18 10:39:59 2016 +0200
keep urls for now
commit de385e56d86b071cf2150ccf9f1aa06ec5187277
Author: Torkel Ödegaard <torkel.odegaard@gmail.com>
Date: Mon Oct 17 17:56:18 2016 +0200
more progress
commit 8469ebc239ab2316cbbc01862e5026737f272f00
Author: Torkel Ödegaard <torkel.odegaard@gmail.com>
Date: Mon Oct 17 17:08:06 2016 +0200
progress on new docs
commit e755f656b12534cfcb23bad11f1fa696e43f7428
Merge: 4644a35 35cce3b
Author: Torkel Ödegaard <torkel.odegaard@gmail.com>
Date: Mon Oct 17 12:21:27 2016 +0200
Merge branch 'new-docs' of github.com:grafana/grafana into new-docs
commit 4644a35102555204787e91041b50dcbfe0f7a213
Merge: 25c4bef 977cdd5
Author: Torkel Ödegaard <torkel.odegaard@gmail.com>
Date: Mon Oct 17 12:21:11 2016 +0200
Merge branch 'master' of github.com:grafana/grafana into new-docs
commit 35cce3bef802fac020a53693b02c112a91a096fc
Author: Torkel Ödegaard <torkel@grafana.org>
Date: Mon Oct 17 09:31:17 2016 +0200
progress on #6170
commit 25c4bef629de7d77218ba95cc3bd25fb50bb19d6
Author: Torkel Ödegaard <torkel.odegaard@gmail.com>
Date: Sun Oct 16 15:05:30 2016 +0200
fix for osx
commit 6c6b52f975630be87da23dd51beafaecb820cec2
Author: Torkel Ödegaard <torkel@grafana.org>
Date: Sun Oct 16 12:56:39 2016 +0200
progress on new docs
commit 6a09633981ab26191d5542dbe3a788846ac6b73d
Author: Torkel Ödegaard <torkel@grafana.org>
Date: Sat Oct 15 11:39:49 2016 +0200
progress on new docs
commit 7d533fbc23e41b86fd1ba9c955dd17ae1ad977e5
Author: Torkel Ödegaard <torkel@grafana.org>
Date: Mon Oct 10 09:25:12 2016 +0200
making progress on new docs site
commit 50392ce98edfa201977716e92e4a86f9d48ae386
Author: Torkel Ödegaard <torkel@grafana.org>
Date: Sun Oct 9 20:02:28 2016 +0200
feat(new docs): progress on new docs site
commit 81a3d3d0952d3a5d790412e90d01ac5a247e0686
Author: Torkel Ödegaard <torkel@grafana.org>
Date: Fri Oct 7 07:52:11 2016 +0200
new docs site experiment
commit 704adc98664665b3624087ab38ce29fc9da005f1
Author: Torkel Ödegaard <torkel@grafana.org>
Date: Sat Oct 1 20:46:53 2016 +0200
new docs poc
135 lines
4.4 KiB
Markdown
135 lines
4.4 KiB
Markdown
+++
|
|
title = "Installing on Debian / Ubuntu"
|
|
description = "Install guide for Grafana"
|
|
keywords = ["grafana", "installation", "documentation"]
|
|
type = "docs"
|
|
[menu.docs]
|
|
name = "Installing on Ubuntu / Debian"
|
|
identifier = "debian"
|
|
parent = "installation"
|
|
weight = 1
|
|
+++
|
|
|
|
# Installing on Debian / Ubuntu
|
|
|
|
Description | Download
|
|
------------ | -------------
|
|
Stable .deb for Debian-based Linux | [3.1.1 (x86-64 deb)](https://grafanarel.s3.amazonaws.com/builds/grafana_3.1.1-1470047149_amd64.deb)
|
|
|
|
## Install Stable
|
|
|
|
$ wget https://grafanarel.s3.amazonaws.com/builds/grafana_3.1.1-1470047149_amd64.deb
|
|
$ sudo apt-get install -y adduser libfontconfig
|
|
$ sudo dpkg -i grafana_3.1.1-1470047149_amd64.deb
|
|
|
|
## APT Repository
|
|
|
|
Add the following line to your `/etc/apt/sources.list` file.
|
|
|
|
deb https://packagecloud.io/grafana/stable/debian/ jessie main
|
|
|
|
Use the above line even if you are on Ubuntu or another Debian version.
|
|
There is also a testing repository if you want beta or release
|
|
candidates.
|
|
|
|
deb https://packagecloud.io/grafana/testing/debian/ jessie main
|
|
|
|
Then add the [Package Cloud](https://packagecloud.io/grafana) key. This
|
|
allows you to install signed packages.
|
|
|
|
$ curl https://packagecloud.io/gpg.key | sudo apt-key add -
|
|
|
|
Update your Apt repositories and install Grafana
|
|
|
|
$ sudo apt-get update
|
|
$ sudo apt-get install grafana
|
|
|
|
On some older versions of Ubuntu and Debian you may need to install the
|
|
`apt-transport-https` package which is needed to fetch packages over
|
|
HTTPS.
|
|
|
|
$ sudo apt-get install -y apt-transport-https
|
|
|
|
## Package details
|
|
|
|
- Installs binary to `/usr/sbin/grafana-server`
|
|
- Installs Init.d script to `/etc/init.d/grafana-server`
|
|
- Creates default file (environment vars) to `/etc/default/grafana-server`
|
|
- Installs configuration file to `/etc/grafana/grafana.ini`
|
|
- Installs systemd service (if systemd is available) name `grafana-server.service`
|
|
- The default configuration sets the log file at `/var/log/grafana/grafana.log`
|
|
- The default configuration specifies an sqlite3 db at `/var/lib/grafana/grafana.db`
|
|
|
|
## Start the server (init.d service)
|
|
|
|
Start Grafana by running:
|
|
|
|
$ sudo service grafana-server start
|
|
|
|
This will start the `grafana-server` process as the `grafana` user,
|
|
which was created during the package installation. The default HTTP port
|
|
is `3000` and default user and group is `admin`.
|
|
|
|
To configure the Grafana server to start at boot time:
|
|
|
|
$ sudo update-rc.d grafana-server defaults
|
|
|
|
## Start the server (via systemd)
|
|
|
|
To start the service using systemd:
|
|
|
|
$ systemctl daemon-reload
|
|
$ systemctl start grafana-server
|
|
$ systemctl status grafana-server
|
|
|
|
Enable the systemd service so that Grafana starts at boot.
|
|
|
|
sudo systemctl enable grafana-server.service
|
|
|
|
## 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 back-end. Here you can override log directory, data
|
|
directory and other variables.
|
|
|
|
### Logging
|
|
|
|
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, as detailed on [the configuration page]({{< relref "configuration.md#database" >}}).
|
|
|
|
## Configuration
|
|
|
|
The configuration file is located at `/etc/grafana/grafana.ini`. Go the
|
|
[Configuration]({{< relref "configuration.md" >}}) page for details on all
|
|
those options.
|
|
|
|
### Adding data sources
|
|
|
|
- [Graphite]({{< relref "datasources/graphite.md" >}})
|
|
- [InfluxDB]({{< relref "datasources/influxdb.md" >}})
|
|
- [OpenTSDB]({{< relref "datasources/opentsdb.md" >}})
|
|
- [Prometheus]({{< relref "datasources/prometheus.md" >}})
|
|
|
|
## Installing from binary tar file
|
|
|
|
Download [the latest `.tar.gz` file](http://grafana.org/download) 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 configuration file named `custom.ini` to the
|
|
`conf` folder and override any of the settings defined in
|
|
`conf/defaults.ini`.
|
|
|
|
Start Grafana by executing `./bin/grafana-server web`. The `grafana-server`
|
|
binary needs the working directory to be the root install directory (where the
|
|
binary and the `public` folder is located).
|
|
|
|
|