In this tutorial, we will provide step-by-step instructions on how to set up the Kibana Plugin Development Environment in the Linux system. We use Ubuntu 18.04.2 Desktop as an example.
Before we start, make sure you are not using the root user and remember to use
sudo for each command.
Step 1 — Install prerequisite tools:
- Install Git:
2. Install NVM:
apt-get update && apt-get install git
apt-get install build-essential libssl-dev
curl https://raw.githubusercontent.com/creationix/nvm/v0.25.0/install.sh | bash
Double check that nvm was successfully installed by running ‘nvm — version’. You should see a version number popup.3. Install yarn:
curl -sS https://dl.yarnpkg.com/debian/pubkey.gpg | sudo apt-key add -
echo "deb https://dl.yarnpkg.com/debian/ stable main" | sudo tee /etc/apt/sources.list.d/yarn.list
sudo apt-get update && sudo apt-get install yarn
Step 2 — Download the Kibana source code:
Download the Kibana source code from Github: https://github.com/elastic/kibana/tree/master
git clone https://github.com/elastic/kibana.git kibana
Optional: By default, the version of the Kibana is latest. If you would like to work on a specific version of Kibana, make sure to run
git checkout your_version_number
Step 3— Install dependencies for Kibana
Make sure you are under the Kibana directory. The layout of the directory should be like like this:
nvm use and follow the instructions on how to install the required nvm version.
Give all the permissions to access Kibana files to the current user by running
chmod -R 777 ./
yarn kbn bootstrap to install all the dependencies. Notice that many errors may occur on this step. You can paste the error messages in the comments and we will help you troubleshoot what’s going on.
Step 4— Generate a plugin template
Run this command to generate a plugin template:
node scripts/generate_plugin your_plugin_name. The plugin files will be in
plugins/your_plugin_name . You need to answer several questions on this step. If you don’t know the answer, then press ENTER to choose the default answer.
Step 5— Start Elasticsearch and Kibana to test the plugin
Now open two terminal windows and run
yarn es snapshot --oss in the first window and run
yarn start -oss in the second window.
-oss means start Elasticsearch and Kibana with only open-source code.
Open your browser and go to http://localhost:5601 . You may be asked to enter the username and password. The default username is
elastic , the default password is
changeme . To access the plugin you just created, expand the left bar and you will see the name of your plugin. Click it and the browser should show something like this:
Since I named my plugin
test , the page shows
test Hello World. Go to
plugin/your_plugin_name to edit or customize your plugin. :)
Interested in Data Exploration or Data Analysis? Follow our linkedin page!
Posted by Minxuan Sun
I am a software developer working at Query.AI ( http://query.ai ). Query.AI provides answers and insights on IT and cybersecurity data residing in log and SIEM platforms like Splunk and ELK / Elasticsearch.