From 94e54ccb38ac6f4bb0df073b1b4a03d4b88c8a5c Mon Sep 17 00:00:00 2001 From: Elastic Jasper Date: Thu, 10 Nov 2016 15:35:12 -0500 Subject: [PATCH] [docs] Add plugin install instructions for packages Backports PR #8934 **Commit 1:** [docs] Add plugin install instructions for packages. Closes #8845 * Original sha: ad6a4f7b536b4ac8f202530d6ab8967acb0240a1 * Authored by Jonathan Budzenski on 2016-11-02T15:04:28Z --- docs/plugins.asciidoc | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/docs/plugins.asciidoc b/docs/plugins.asciidoc index 61af5f2f2e93e..4a043cb710be9 100644 --- a/docs/plugins.asciidoc +++ b/docs/plugins.asciidoc @@ -44,6 +44,20 @@ $ bin/kibana-plugin install file:///some/local/path/x-pack.zip -d path/to/direct NOTE: This command creates the specified directory if it does not already exist. +[float] +=== Installing Plugins with Linux packages + +The Kibana server needs to be able to write to files in the `optimize` directory. If you're installing plugins using sudo or su you'll +want to make sure these commands are ran as the user `kibana`. This user is already added for you as part of the package installation. + +[source,shell] +$ sudo -u kibana bin/kibana-plugin install x-pack + +If plugins were installed as a different user and the server is not starting, then you will need to change the owner of these files: + +[source,shell] +$ chown -R kibana:kibana /path/to/kibana/optimize + == Updating & Removing Plugins To update a plugin, remove the current version and reinstall the plugin.