Installing Kibana

Kibana is provided in the following package formats:

tar.gz/zip

The tar.gz packages are provided for installation on Linux and Darwin and are the easiest choice for getting started with Kibana.

The zip package is the only supported package for Windows.

Install Kibana with .tar.gz or Install Kibana on Windows

deb

The deb package is suitable for Debian, Ubuntu, and other Debian-based systems. Debian packages may be downloaded from the Elastic website or from our Debian repository.

Install Kibana with Debian Package

rpm

The rpm package is suitable for installation on Red Hat, Centos, SLES, OpenSuSE and other RPM-based systems. RPMs may be downloaded from the Elastic website or from our RPM repository.

Install Kibana with RPM

docker

An image is available for running Kibana as a Docker container. It ships with X-Pack pre-installed and is available from the Elastic Docker registry.

Running Kibana on Docker

Important

If your Elasticsearch installation is protected by X-Pack Security see Using Kibana with X-Pack Security for additional setup instructions.

Install Kibana with .tar.gz

Kibana is provided for Linux and Darwin as a .tar.gz package. These packages are the easiest formats to use when trying out Kibana.

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

Download and install the Linux 64-bit package

The 64-bit Linux archive for Kibana v5.1.1 can be downloaded and installed as follows:

wget https://artifacts.elastic.co/downloads/kibana/kibana-5.1.1-linux-x86_64.tar.gz
sha1sum kibana-5.1.1-linux-x86_64.tar.gz 
tar -xzf kibana-5.1.1-linux-x86_64.tar.gz
cd kibana/ 

Compare the SHA produced by sha1sum or shasum with the published SHA.

This directory is known as $KIBANA_HOME.

Download and install the Linux 32-bit package

The 32-bit Linux archive for Kibana v5.1.1 can be downloaded and installed as follows:

wget https://artifacts.elastic.co/downloads/kibana/kibana-5.1.1-linux-x86.tar.gz
sha1sum kibana-5.1.1-linux-x86.tar.gz 
tar -xzf kibana-5.1.1-linux-x86.tar.gz
cd kibana/ 

Compare the SHA produced by sha1sum or shasum with the published SHA.

This directory is known as $KIBANA_HOME.

Download and install the Darwin package

The Darwin archive for Kibana v5.1.1 can be downloaded and installed as follows:

wget https://artifacts.elastic.co/downloads/kibana/kibana-5.1.1-darwin-x86_64.tar.gz
shasum kibana-5.1.1-darwin-x86_64.tar.gz 
tar -xzf kibana-5.1.1-darwin-x86_64.tar.gz
cd kibana/ 

Compare the SHA produced by sha1sum or shasum with the published SHA.

This directory is known as $KIBANA_HOME.

Running Kibana from the command line

Kibana can be started from the command line as follows:

./bin/kibana

By default, Kibana runs in the foreground, prints its logs to the standard output (stdout), and can be stopped by pressing Ctrl-C.

Configuring Kibana via config file

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

Directory layout of .tar.gz archives

The .tar.gz packages are entirely self-contained. All files and directories are, by default, contained within $KIBANA_HOME — the directory created when unpacking the archive.

This is very convenient because you don’t have to create any directories to start using Kibana, and uninstalling Kibana is as easy as removing the $KIBANA_HOME directory. However, it is advisable to change the default locations of the config and data directories so that you do not delete important data later on.

Type Description Default Location Setting

home

Kibana home directory or $KIBANA_HOME

Directory created by unpacking the archive

bin

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

$KIBANA_HOME\bin

config

Configuration files including kibana.yml

$KIBANA_HOME\config

data

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

$KIBANA_HOME\data

optimize

Transpiled source code. Certain administrative actions (e.g. plugin install) result in the source code being retranspiled on the fly.

$KIBANA_HOME\optimize

plugins

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

$KIBANA_HOME\plugins

Install Kibana with Debian Package

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.

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

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 -

Installing from the APT repository

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-5.x.list:

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

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:

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

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

Download and install the Debian package manually

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

64 bit:

wget https://artifacts.elastic.co/downloads/kibana/kibana-5.1.1-amd64.deb
sha1sum kibana-5.1.1-amd64.deb 
sudo dpkg -i kibana-5.1.1-amd64.deb

Compare the SHA produced by sha1sum or shasum with the published SHA.

32 bit:

wget https://artifacts.elastic.co/downloads/kibana/kibana-5.1.1-i386.deb
sha1sum kibana-5.1.1-i386.deb 
sudo dpkg -i kibana-5.1.1-i386.deb

Compare the SHA produced by sha1sum or shasum with the published SHA.

SysV init vs systemd

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

Running Kibana with SysV init

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

Kibana can be started and stopped 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/.

Running Kibana with systemd

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. Instead, this information will be written in the log files located in /var/log/kibana/.

Configuring Kibana via config file

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

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

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

Install Kibana with RPM

The RPM for Kibana can be downloaded from our website or from our RPM repository. It can be used to install Kibana on any RPM-based system such as OpenSuSE, SLES, Centos, Red Hat, and Oracle Enterprise.

Note

RPM install is not supported on distributions with old versions of RPM, such as SLES 11 and CentOS 5. Please see Install Kibana with .tar.gz instead.

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

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:

rpm --import https://artifacts.elastic.co/GPG-KEY-elasticsearch

Installing from the RPM repository

Create a file called kibana.repo in the /etc/yum.repos.d/ directory for RedHat based distributions, or in the /etc/zypp/repos.d/ directory for OpenSuSE based distributions, containing:

[kibana-5.x]
name=Kibana repository for 5.x packages
baseurl=https://artifacts.elastic.co/packages/5.x/yum
gpgcheck=1
gpgkey=https://artifacts.elastic.co/GPG-KEY-elasticsearch
enabled=1
autorefresh=1
type=rpm-md

And your repository is ready for use. You can now install Kibana with one of the following commands:

sudo yum install kibana 
sudo dnf install kibana 
sudo zypper install kibana 

Use yum on CentOS and older Red Hat based distributions.

Use dnf on Fedora and other newer Red Hat distributions.

Use zypper on OpenSUSE based distributions

Download and install the RPM manually

The RPM for Kibana v5.1.1 can be downloaded from the website and installed as follows:

64 bit:

wget https://artifacts.elastic.co/downloads/kibana/kibana-5.1.1-x86_64.rpm
sha1sum kibana-5.1.1-x86_64.rpm 
sudo rpm --install kibana-5.1.1-x86_64.rpm

Compare the SHA produced by sha1sum or shasum with the published SHA.

32 bit:

wget https://artifacts.elastic.co/downloads/kibana/kibana-5.1.1-i686.rpm
sha1sum kibana-5.1.1-i686.rpm 
sudo rpm --install kibana-5.1.1-i686.rpm

Compare the SHA produced by sha1sum or shasum with the published SHA.

SysV init vs systemd

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

Running Kibana with SysV init

Use the chkconfig command to configure Kibana to start automatically when the system boots up:

sudo chkconfig --add kibana

Kibana can be started and stopped 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/.

Running Kibana with systemd

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. Instead, this information will be written in the log files located in /var/log/kibana/.

Configuring Kibana via config file

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 RPM

The RPM places config files, logs, and the data directory in the appropriate locations for an RPM-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

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

Install Kibana on Windows

Kibana can be installed on Windows using the .zip package.

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

Download and install the .zip package

Download the .zip windows archive for Kibana v5.1.1 from https://artifacts.elastic.co/downloads/kibana/kibana-5.1.1-windows-x86.zip

Unzip it with your favourite unzip tool. This will create a folder called kibana-5.1.1-windows-x86, which we will refer to as $KIBANA_HOME. In a terminal window, CD to the $KIBANA_HOME directory, for instance:

CD c:\kibana-5.1.1-windows-x86

Running Kibana from the command line

Kibana can be started from the command line as follows:

.\bin\kibana

By default, Kibana runs in the foreground, prints its logs to STDOUT, and can be stopped by pressing Ctrl-C.

Configuring Kibana via config file

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

Directory layout of .zip archive

The .zip package is entirely self-contained. All files and directories are, by default, contained within $KIBANA_HOME — the directory created when unpacking the archive.

This is very convenient because you don’t have to create any directories to start using Kibana, and uninstalling Kibana is as easy as removing the $KIBANA_HOME directory. However, it is advisable to change the default locations of the config and data directories so that you do not delete important data later on.

Type Description Default Location Setting

home

Kibana home directory or $KIBANA_HOME

Directory created by unpacking the archive

bin

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

$KIBANA_HOME\bin

config

Configuration files including kibana.yml

$KIBANA_HOME\config

data

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

$KIBANA_HOME\data

optimize

Transpiled source code. Certain administrative actions (e.g. plugin install) result in the source code being retranspiled on the fly.

$KIBANA_HOME\optimize

plugins

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

$KIBANA_HOME\plugins