elasticsearch-head

A web front end for an ElasticSearch cluster

http://mobz.github.com/elasticsearch-head

Installing and Running

There are two ways of running and installing elasticsearch-head

Running as a plugin of ElasticSearch (this is the preferred method)

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

Running with built in server

• 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

Running from the filesystem

• 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

Alternatives

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.

URL Parameters

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 )

Contributing

To contribute to elasticsearch-head you will need the following developer tools

1. git and a github account
2. node
3. grunt-cli

Then

1. create a fork of elasticsearch-head on github
2. clone your fork to your machine
3. cd elasticsearch-head
4. npm install # downloads node dev dependencies
5. grunt 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