Install Kibana with Debian package

edit

Install Kibana with Debian package

edit

The Debian package for Kibana can be downloaded from our website or from our APT repository. It can be used to install Kibana on any Debian-based system such as Debian and Ubuntu.

This package is free to use under the Elastic license. It contains open source and free commercial features and access to paid commercial features. Start a 30-day trial to try out all of the paid commercial features. See the Subscriptions page for information about Elastic license levels.

The latest stable version of Kibana can be found on the Download Kibana page. Other versions can be found on the Past Releases page.

Import the Elastic PGP key

edit

We sign all of our packages with the Elastic Signing Key (PGP key D88E42B4, available from https://pgp.mit.edu) with fingerprint:

4609 5ACC 8548 582C 1A26 99A9 D27D 666C D88E 42B4

Download and install the public signing key:

wget -qO - https://artifacts.elastic.co/GPG-KEY-elasticsearch | sudo apt-key add -

Install from the APT repository

edit

You may need to install the apt-transport-https package on Debian before proceeding:

sudo apt-get install apt-transport-https

Save the repository definition to /etc/apt/sources.list.d/elastic-7.x.list:

echo "deb https://artifacts.elastic.co/packages/7.x/apt stable main" | sudo tee -a /etc/apt/sources.list.d/elastic-7.x.list

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:

sudo apt-get update && sudo apt-get install kibana

If two entries exist for the same Kibana repository, you will see an error like this during apt-get update:

Duplicate sources.list entry https://artifacts.elastic.co/packages/7.x/apt/ ...`

Examine /etc/apt/sources.list.d/kibana-7.x.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.

An alternative package, kibana-oss, which contains only features that are available under the Apache 2.0 license is also available. To install it, use the following sources list:

echo "deb https://artifacts.elastic.co/packages/oss-7.x/apt stable main" | sudo tee -a /etc/apt/sources.list.d/elastic-7.x.list

Download and install the Debian package manually

edit

The Debian package for Kibana v7.9.3 can be downloaded from the website and installed as follows:

wget https://artifacts.elastic.co/downloads/kibana/kibana-7.9.3-amd64.deb
shasum -a 512 kibana-7.9.3-amd64.deb 
sudo dpkg -i kibana-7.9.3-amd64.deb

Compare the SHA produced by shasum with the published SHA.

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-7.9.3-amd64.deb

SysV init vs systemd

edit

Kibana is not started automatically after installation. How to start and stop Kibana depends on whether your system uses SysV init or systemd (used by newer distributions). You can tell which is being used by running this command:

ps -p 1

Run Kibana with SysV init

edit

Use the update-rc.d command to configure Kibana to start automatically when the system boots up:

sudo update-rc.d kibana defaults 95 10

You can start and stop Kibana using the service command:

sudo -i service kibana start
sudo -i service kibana stop

If Kibana fails to start for any reason, it will print the reason for failure to STDOUT. Log files can be found in /var/log/kibana/.

Run Kibana with systemd

edit

To configure Kibana to start automatically when the system boots up, run the following commands:

sudo /bin/systemctl daemon-reload
sudo /bin/systemctl enable kibana.service

Kibana can be started and stopped as follows:

sudo systemctl start kibana.service
sudo systemctl stop kibana.service

These commands provide no feedback as to whether Kibana was started successfully or not. Log information can be accessed via journalctl -u kibana.service.

Configure Kibana via the config file

edit

Kibana loads its configuration from the /etc/kibana/kibana.yml file by default. The format of this config file is explained in Configuring Kibana.

Directory layout of Debian package

edit

The Debian package places config files, logs, and the data directory in the appropriate locations for a Debian-based system:

Type Description Default Location Setting

home

Kibana home directory or $KIBANA_HOME

/usr/share/kibana

bin

Binary scripts including kibana to start the Kibana server and kibana-plugin to install plugins

/usr/share/kibana/bin

config

Configuration files including kibana.yml

/etc/kibana

data

The location of the data files written to disk by Kibana and its plugins

/var/lib/kibana

path.data

logs

Logs files location

/var/log/kibana

path.logs

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

plugins

Plugin files location. Each plugin will be contained in a subdirectory.

/usr/share/kibana/plugins