2016-10-25 03:41:32 +02:00
[[deb]]
=== Install Kibana with Debian Package
The Debian package for Kibana can be <<install-deb,downloaded from our website>>
2018-04-25 08:14:33 +02:00
or from our <<deb-repo,APT repository>>. It can be used to install
2016-10-25 03:41:32 +02:00
Kibana on any Debian-based system such as Debian and Ubuntu.
2018-04-25 08:14:33 +02:00
This package is free to use under the Elastic license. It contains open source
and free commercial features and access to paid commercial features.
{xpack-ref}/license-management.html[Start a 30-day trial] to try out all of the
paid commercial features. See the
https://www.elastic.co/subscriptions[Subscriptions] page for information about
Elastic license levels.
2016-10-25 03:41:32 +02:00
The latest stable version of Kibana can be found on the
link:/downloads/kibana[Download Kibana] page. Other versions can
be found on the link:/downloads/past-releases[Past Releases page].
[[deb-key]]
==== Import the Elastic PGP Key
include::key.asciidoc[]
[source,sh]
-------------------------
wget -qO - https://artifacts.elastic.co/GPG-KEY-elasticsearch | sudo apt-key add -
-------------------------
[[deb-repo]]
==== Installing from the APT repository
ifeval::["{release-state}"=="unreleased"]
Version {version} of Kibana has not yet been released.
endif::[]
ifeval::["{release-state}"!="unreleased"]
You may need to install the `apt-transport-https` package on Debian before proceeding:
[source,sh]
--------------------------------------------------
sudo apt-get install apt-transport-https
--------------------------------------------------
Save the repository definition to +/etc/apt/sources.list.d/elastic-{major-version}.list+:
ifeval::["{release-state}"=="released"]
["source","sh",subs="attributes,callouts"]
--------------------------------------------------
2016-10-25 15:49:42 +02:00
echo "deb https://artifacts.elastic.co/packages/{major-version}/apt stable main" | sudo tee -a /etc/apt/sources.list.d/elastic-{major-version}.list
2016-10-25 03:41:32 +02:00
--------------------------------------------------
endif::[]
ifeval::["{release-state}"=="prerelease"]
["source","sh",subs="attributes,callouts"]
--------------------------------------------------
2016-10-25 15:49:42 +02:00
echo "deb https://artifacts.elastic.co/packages/{major-version}-prerelease/apt stable main" | sudo tee -a /etc/apt/sources.list.d/elastic-{major-version}.list
2016-10-25 03:41:32 +02:00
--------------------------------------------------
endif::[]
[WARNING]
==================================================
Do not use `add-apt-repository` as it will add a `deb-src` entry as well, but
we do not provide a source package. If you have added the `deb-src` entry, you
will see an error like the following:
Unable to find expected entry 'main/source/Sources' in Release file
(Wrong sources.list entry or malformed file)
Delete the `deb-src` entry from the `/etc/apt/sources.list` file and the
installation should work as expected.
==================================================
You can install the Kibana Debian package with:
[source,sh]
--------------------------------------------------
sudo apt-get update && sudo apt-get install kibana
--------------------------------------------------
[WARNING]
==================================================
If two entries exist for the same Kibana repository, you will see an error like this during `apt-get update`:
["literal",subs="attributes,callouts"]
Duplicate sources.list entry https://artifacts.elastic.co/packages/{major-version}/apt/ ...`
Examine +/etc/apt/sources.list.d/kibana-{major-version}.list+ for the duplicate entry or locate the duplicate entry amongst the files in `/etc/apt/sources.list.d/` and the `/etc/apt/sources.list` file.
==================================================
endif::[]
[[install-deb]]
==== Download and install the Debian package manually
ifeval::["{release-state}"=="unreleased"]
Version {version} of Kibana has not yet been released.
endif::[]
ifeval::["{release-state}"!="unreleased"]
The Debian package for Kibana v{version} can be downloaded from the website and installed as follows:
["source","sh",subs="attributes"]
--------------------------------------------
2016-10-26 03:40:37 +02:00
wget https://artifacts.elastic.co/downloads/kibana/kibana-{version}-amd64.deb
2018-04-03 17:13:53 +02:00
shasum -a 512 kibana-{version}-amd64.deb <1>
2016-10-26 03:40:37 +02:00
sudo dpkg -i kibana-{version}-amd64.deb
2016-10-25 03:41:32 +02:00
--------------------------------------------
2018-04-03 17:13:53 +02:00
<1> Compare the SHA produced by `shasum` with the
https://artifacts.elastic.co/downloads/kibana/kibana-{version}-amd64.deb.sha512[published SHA].
2016-10-26 03:40:37 +02:00
2018-04-25 08:14:33 +02:00
Alternatively, you can download the following package, which contains only
features that are available under the Apache 2.0 license:
https://artifacts.elastic.co/downloads/kibana/kibana-oss-{version}-amd64.deb
2016-10-25 03:41:32 +02:00
endif::[]
2018-07-03 20:30:08 +02:00
==== SysV `init` vs `systemd`
2016-10-25 03:41:32 +02:00
include::init-systemd.asciidoc[]
[[deb-running-init]]
2018-07-03 20:30:08 +02:00
include::deb-init.asciidoc[]
2016-10-25 03:41:32 +02:00
[[deb-running-systemd]]
2018-07-03 20:30:08 +02:00
2016-10-25 03:41:32 +02:00
include::systemd.asciidoc[]
[[deb-configuring]]
2016-10-25 20:23:26 +02:00
==== Configuring Kibana via config file
2016-10-25 03:41:32 +02:00
Kibana loads its configuration from the `/etc/kibana/kibana.yml`
file by default. The format of this config file is explained in
2017-07-18 23:41:06 +02:00
{kibana-ref}/settings.html[Configuring Kibana].
2016-10-25 03:41:32 +02:00
[[deb-layout]]
==== Directory layout of Debian package
The Debian package places config files, logs, and the data directory in the appropriate
locations for a Debian-based system:
[cols="<h,<,<m,<m",options="header",]
|=======================================================================
| Type | Description | Default Location | Setting
| home
| Kibana home directory or `$KIBANA_HOME`
| /usr/share/kibana
d|
| bin
| Binary scripts including `kibana` to start the Kibana server
and `kibana-plugin` to install plugins
| /usr/share/kibana/bin
d|
| config
| Configuration files including `kibana.yml`
| /etc/kibana
d|
| data
| The location of the data files written to disk by Kibana and its plugins
| /var/lib/kibana
2017-08-31 17:16:50 +02:00
| path.data
2016-10-25 03:41:32 +02:00
| optimize
| Transpiled source code. Certain administrative actions (e.g. plugin install)
result in the source code being retranspiled on the fly.
| /usr/share/kibana/optimize
d|
| plugins
| Plugin files location. Each plugin will be contained in a subdirectory.
| /usr/share/kibana/plugins
d|
|=======================================================================