Installing X-Pack in Kibana

After you install Kibana, you can optionally obtain and install X-Pack. For more information about how to obtain X-Pack, see https://www.elastic.co/products/x-pack.

Note

You must run the version of X-Pack that matches the version of Kibana you are running. See the Elastic Support Matrix for more information about product compatibility.

The following diagram provides an overview of the steps that are required to set up X-Pack on Kibana:

Installation overview on Kibana

To install X-Pack in Kibana:

  1. If you have not done so already, install X-Pack on Elasticsearch.
  2. Optional: If you want to install X-Pack on a machine that doesn’t have internet access:

    1. Manually download the X-Pack zip file: https://artifacts.elastic.co/downloads/packs/x-pack/x-pack-6.0.1.zip (sha512)

      Note

      The plugins for Elasticsearch, Kibana, and Logstash are included in the same zip file. If you have already downloaded this file to install X-Pack on one of those other products, you can reuse the same file.

    2. Transfer the zip file to a temporary directory on the offline machine. (Do NOT put the file in the Elasticsearch plugins directory.)
  3. Run bin/kibana-plugin in your Kibana installation directory.

    bin/kibana-plugin install x-pack

    The plugin install scripts require direct internet access to download and install X-Pack. If your server doesn’t have internet access, specify the location of the X-Pack zip file that you downloaded to a temporary directory.

    bin/kibana-plugin install file:///path/to/file/x-pack-6.0.1.zip

    The Kibana server needs to be able to write to files in the optimize directory. If you’re using sudo or su, run the plugin installation as the built-in kibana user. For example:

    sudo -u kibana bin/kibana-plugin install x-pack

    For more information, see Installing Plugins.

  4. Update Kibana to use the new password for the built-in kibana user, which you set up along with the other built-in users when you installed X-Pack on Elasticsearch. You must configure the elasticsearch.password setting in the kibana.yml configuration file with the new password for the kibana user.

    elasticsearch.username: "kibana"
    elasticsearch.password: "kibanapassword"

    For more information, see Setting Up User Authentication.

  5. Start Kibana.

    bin/kibana
  6. To verify X-Pack installation, point your web browser at http://localhost:5601/ to open Kibana. You should be prompted to log in. You can use any Elasticsearch user that has the kibana_user role. The built-in kibana user, however, should be used only internally by the Kibana server. For more information, see Built-in Roles.
  7. Install X-Pack on Logstash.

For more information about installing X-Pack across the Elastic Stack, see Installing X-Pack.