2016-10-25 03:41:32 +02:00
|
|
|
|
[[targz]]
|
2020-06-09 01:15:20 +02:00
|
|
|
|
=== Install {kib} from archive on Linux or macOS
|
2020-06-10 20:01:19 +02:00
|
|
|
|
++++
|
|
|
|
|
<titleabbrev>Install from archive on Linux or macOS</titleabbrev>
|
|
|
|
|
++++
|
2016-10-25 03:41:32 +02:00
|
|
|
|
|
|
|
|
|
Kibana is provided for Linux and Darwin as a `.tar.gz` package. These packages
|
|
|
|
|
are the easiest formats to use when trying out Kibana.
|
|
|
|
|
|
2021-02-05 17:39:03 +01:00
|
|
|
|
This package contains both free and subscription features.
|
|
|
|
|
<<managing-licenses,Start a 30-day trial>> to try out all of the features.
|
2018-04-25 08:14:33 +02:00
|
|
|
|
|
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].
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
[[install-linux64]]
|
|
|
|
|
==== Download and install the Linux 64-bit package
|
|
|
|
|
|
|
|
|
|
ifeval::["{release-state}"=="unreleased"]
|
|
|
|
|
|
|
|
|
|
Version {version} of Kibana has not yet been released.
|
|
|
|
|
|
|
|
|
|
endif::[]
|
|
|
|
|
|
|
|
|
|
ifeval::["{release-state}"!="unreleased"]
|
|
|
|
|
|
2017-05-25 22:15:25 +02:00
|
|
|
|
The Linux archive for Kibana v{version} can be downloaded and installed as follows:
|
2016-10-25 03:41:32 +02:00
|
|
|
|
|
|
|
|
|
["source","sh",subs="attributes"]
|
|
|
|
|
--------------------------------------------
|
2019-11-22 01:30:05 +01:00
|
|
|
|
curl -O https://artifacts.elastic.co/downloads/kibana/kibana-{version}-linux-x86_64.tar.gz
|
|
|
|
|
curl https://artifacts.elastic.co/downloads/kibana/kibana-{version}-linux-x86_64.tar.gz.sha512 | shasum -a 512 -c - <1>
|
2016-10-25 03:41:32 +02:00
|
|
|
|
tar -xzf kibana-{version}-linux-x86_64.tar.gz
|
2017-08-29 18:28:22 +02:00
|
|
|
|
cd kibana-{version}-linux-x86_64/ <2>
|
2016-10-25 03:41:32 +02:00
|
|
|
|
--------------------------------------------
|
2019-11-22 01:30:05 +01:00
|
|
|
|
<1> Compares the SHA of the downloaded `.tar.gz` archive and the published checksum, which should output
|
|
|
|
|
`kibana-{version}-linux-x86_64.tar.gz: OK`.
|
2016-10-25 03:41:32 +02:00
|
|
|
|
<2> This directory is known as `$KIBANA_HOME`.
|
|
|
|
|
|
|
|
|
|
endif::[]
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
[[install-darwin64]]
|
|
|
|
|
==== Download and install the Darwin package
|
|
|
|
|
|
2020-02-07 00:18:23 +01:00
|
|
|
|
[IMPORTANT]
|
|
|
|
|
.macOS Gatekeeper warnings
|
|
|
|
|
====
|
|
|
|
|
Apple's rollout of stricter notarization requirements affected the notarization
|
|
|
|
|
of the {version} {kib} artifacts. If macOS Catalina displays a dialog when you
|
|
|
|
|
first run {kib} that interrupts it, you will need to take an action to allow it
|
|
|
|
|
to run.
|
|
|
|
|
|
|
|
|
|
To prevent Gatekeeper checks on the {kib} files, run the following command on the
|
|
|
|
|
downloaded `.tar.gz` archive or the directory to which was extracted:
|
|
|
|
|
[source,sh]
|
|
|
|
|
----
|
|
|
|
|
xattr -d -r com.apple.quarantine <archive-or-directory>
|
|
|
|
|
----
|
|
|
|
|
|
|
|
|
|
Alternatively, you can add a security override if a Gatekeeper popup appears by
|
|
|
|
|
following the instructions in the _How to open an app that hasn’t been notarized
|
|
|
|
|
or is from an unidentified developer_ section of
|
|
|
|
|
https://support.apple.com/en-us/HT202491[Safely open apps on your Mac].
|
|
|
|
|
====
|
|
|
|
|
|
2016-10-25 03:41:32 +02:00
|
|
|
|
ifeval::["{release-state}"=="unreleased"]
|
|
|
|
|
|
|
|
|
|
Version {version} of Kibana has not yet been released.
|
|
|
|
|
|
|
|
|
|
endif::[]
|
|
|
|
|
|
|
|
|
|
ifeval::["{release-state}"!="unreleased"]
|
|
|
|
|
|
|
|
|
|
The Darwin archive for Kibana v{version} can be downloaded and installed as follows:
|
|
|
|
|
|
|
|
|
|
["source","sh",subs="attributes"]
|
|
|
|
|
--------------------------------------------
|
2017-08-23 02:47:12 +02:00
|
|
|
|
curl -O https://artifacts.elastic.co/downloads/kibana/kibana-{version}-darwin-x86_64.tar.gz
|
2019-11-22 01:30:05 +01:00
|
|
|
|
curl https://artifacts.elastic.co/downloads/kibana/kibana-{version}-darwin-x86_64.tar.gz.sha512 | shasum -a 512 -c - <1>
|
2016-10-25 03:41:32 +02:00
|
|
|
|
tar -xzf kibana-{version}-darwin-x86_64.tar.gz
|
2017-08-29 18:28:22 +02:00
|
|
|
|
cd kibana-{version}-darwin-x86_64/ <2>
|
2016-10-25 03:41:32 +02:00
|
|
|
|
--------------------------------------------
|
2019-11-22 01:30:05 +01:00
|
|
|
|
<1> Compares the SHA of the downloaded `.tar.gz` archive and the published checksum, which should output
|
|
|
|
|
`kibana-{version}-darwin-x86_64.tar.gz: OK`.
|
2016-10-25 03:41:32 +02:00
|
|
|
|
<2> This directory is known as `$KIBANA_HOME`.
|
|
|
|
|
|
|
|
|
|
endif::[]
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
[[targz-running]]
|
2018-07-03 20:30:08 +02:00
|
|
|
|
include::targz-running.asciidoc[]
|
2016-10-25 03:41:32 +02:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
[[targz-configuring]]
|
2020-06-09 01:15:20 +02:00
|
|
|
|
==== Configure {kib} via the config file
|
2016-10-25 03:41:32 +02:00
|
|
|
|
|
|
|
|
|
Kibana loads its configuration from the `$KIBANA_HOME/config/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
|
|
|
|
|
|
|
|
|
|
|
|
|
|
[[targz-layout]]
|
|
|
|
|
==== 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.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
[cols="<h,<,<m,<m",options="header",]
|
|
|
|
|
|=======================================================================
|
|
|
|
|
| Type | Description | Default Location | Setting
|
|
|
|
|
| home
|
2016-10-25 20:23:26 +02:00
|
|
|
|
| Kibana home directory or `$KIBANA_HOME`
|
2016-10-25 03:41:32 +02:00
|
|
|
|
d| Directory created by unpacking the archive
|
|
|
|
|
d|
|
|
|
|
|
|
|
|
|
|
| bin
|
|
|
|
|
| Binary scripts including `kibana` to start the Kibana server
|
|
|
|
|
and `kibana-plugin` to install plugins
|
2016-10-25 20:23:26 +02:00
|
|
|
|
| $KIBANA_HOME\bin
|
2016-10-25 03:41:32 +02:00
|
|
|
|
d|
|
|
|
|
|
|
|
|
|
|
| config
|
|
|
|
|
| Configuration files including `kibana.yml`
|
2016-10-25 20:23:26 +02:00
|
|
|
|
| $KIBANA_HOME\config
|
2021-02-10 17:01:49 +01:00
|
|
|
|
| <<settings,KBN_PATH_CONF>>
|
2016-10-25 03:41:32 +02:00
|
|
|
|
d|
|
|
|
|
|
|
|
|
|
|
| data
|
|
|
|
|
| The location of the data files written to disk by Kibana and its plugins
|
2016-10-25 20:23:26 +02:00
|
|
|
|
| $KIBANA_HOME\data
|
2016-10-25 03:41:32 +02:00
|
|
|
|
d|
|
|
|
|
|
|
|
|
|
|
| plugins
|
|
|
|
|
| Plugin files location. Each plugin will be contained in a subdirectory.
|
2016-10-25 20:23:26 +02:00
|
|
|
|
| $KIBANA_HOME\plugins
|
2016-10-25 03:41:32 +02:00
|
|
|
|
d|
|
|
|
|
|
|
|
|
|
|
|=======================================================================
|