There are two ways of running and installing elasticsearch-head
If you’ve installed the .deb package, then the plugin exectuable will be available at /usr/share/elasticsearch/bin/plugin.
sudo elasticsearch/bin/plugin -install mobz/elasticsearch-head
open http://localhost:9200/_plugin/head/
This will automatically download the latest version of elasticsearch-head from github and run it as a plugin within the elasticsearch cluster. In this mode;
- elasticsearch provides a simple webserver to run head
- elasticsearch-head automatically connects to the node that is running it
- is available at http://localhost:9200/_plugin/head/ (or whatever the address of your cluster is)
- Will not work with elasticsearch prior to version 0.17
git clone git://github.com/mobz/elasticsearch-head.git
cd elasticsearch-head
npm install
grunt server
- @open http://localhost:9100/
This will start a local webserver running on port 9100 serving elasticsearch-head
- Best option if you are likely to connect to serveral different clusters
git clone git://github.com/mobz/elasticsearch-head.git
cd elasticsearch-head
open index.html
This will manually download the latest version of elasticsearch-head from github and run it standalone. In this mode;
- elasticsearch-head is running from the file system and some features will not work
- may have trouble connecting to the node if the node is protected by some security measures
elastisearch-head is a standalone webapp written in good-ol’ html5. This means, you can put it up on any webserver, run it directly from the filesystem, use it on an ipad, or put it on a floppy disk and carry it with you.
Parameters may be appended to the url set some initial state eg. head/index.html?base_uri=http://node-01.example.com:9200
base_uri
force elasticsearch-head to connect to a particular node.auth_user
adds basic auth credentials to http requests ( requires elasticsearch-http-basic plugin)auth_password
basic auth password as above (note: without additional security layers, passwords are sent over the network in the clear )
To contribute to elasticsearch-head you will need the following developer tools
Then
- create a fork of elasticsearch-head on github
- clone your fork to your machine
cd elasticsearch-head
npm install
# downloads node dev dependenciesgrunt default watch
# builds the distribution files, then watches the src directory for changes
Changes to both dist and src directories changes should be committed, to allow people to run head without running dev tools