WARNING: Version 1.3 of Elasticsearch has passed its EOL date.
This documentation is no longer being maintained and may be removed. If you are running this version, we strongly advise you to upgrade. For the latest information, see the current release documentation.
Plugins
editPlugins
editPlugins
editPlugins are a way to enhance the basic elasticsearch functionality in a custom manner. They range from adding custom mapping types, custom analyzers (in a more built in fashion), native scripts, custom discovery and more.
Installing plugins
editInstalling plugins can either be done manually by placing them under the
plugins
directory, or using the plugin
script. Several plugins can
be found under the elasticsearch
organization in GitHub, starting with elasticsearch-
.
Installing plugins typically take the following form:
plugin --install <org>/<user/component>/<version>
The plugins will be
automatically downloaded in this case from download.elastic.co
,
and in case they don’t exist there, from maven (central and sonatype).
Note that when the plugin is located in maven central or sonatype
repository, <org>
is the artifact groupId
and <user/component>
is
the artifactId
.
A plugin can also be installed directly by specifying the URL for it, for example:
bin/plugin --url file:///path/to/plugin --install plugin-name
You can run bin/plugin -h
.
Site Plugins
editPlugins can have "sites" in them, any plugin that exists under the
plugins
directory with a _site
directory, its content will be
statically served when hitting /_plugin/[plugin_name]/
url. Those can
be added even after the process has started.
Installed plugins that do not contain any java related content, will
automatically be detected as site plugins, and their content will be
moved under _site
.
The ability to install plugins from Github allows to easily install site plugins hosted there by downloading the actual repo, for example, running:
bin/plugin --install mobz/elasticsearch-head bin/plugin --install lukas-vlcek/bigdesk
Will install both of those site plugins, with elasticsearch-head
available under http://localhost:9200/_plugin/head/
and bigdesk
available under http://localhost:9200/_plugin/bigdesk/
.
Mandatory Plugins
editIf you rely on some plugins, you can define mandatory plugins using the
plugin.mandatory
attribute, for example, here is a sample config:
plugin.mandatory: mapper-attachments,lang-groovy
For safety reasons, if a mandatory plugin is not installed, the node will not start.
Installed Plugins
editA list of the currently loaded plugins can be retrieved using the Node Info API.
Removing plugins
editRemoving plugins can either be done manually by removing them under the
plugins
directory, or using the plugin
script.
Removing plugins typically take the following form:
plugin --remove <pluginname>
Silent/Verbose mode
editWhen running the plugin
script, you can get more information (debug mode) using --verbose
.
On the opposite, if you want plugin
script to be silent, use --silent
option.
Note that exit codes could be:
-
0
: everything was OK -
64
: unknown command or incorrect option parameter -
74
: IO error -
70
: other errors
bin/plugin --install mobz/elasticsearch-head --verbose plugin --remove head --silent
Timeout settings
editBy default, the plugin
script will wait indefinitely when downloading before failing.
The timeout parameter can be used to explicitly specify how long it waits. Here is some examples of setting it to
different values:
# Wait for 30 seconds before failing bin/plugin --install mobz/elasticsearch-head --timeout 30s # Wait for 1 minute before failing bin/plugin --install mobz/elasticsearch-head --timeout 1m # Wait forever (default) bin/plugin --install mobz/elasticsearch-head --timeout 0
Proxy settings
editTo install a plugin via a proxy, you can pass the proxy details using the environment variables proxyHost
and proxyPort
.
On Linux and Mac, here is an example of setting it:
bin/plugin -DproxyHost=host_name -DproxyPort=port_number --install mobz/elasticsearch-head
On Windows, here is an example of setting it:
set JAVA_OPTS="-DproxyHost=host_name -DproxyPort=port_number" bin/plugin --install mobz/elasticsearch-head
Lucene version dependent plugins
editAdded in 1.2.0.
For some plugins, such as analysis plugins, a specific major Lucene version is
required to run. In that case, the plugin provides in its es-plugin.properties
file the Lucene version for which the plugin was built for.
If present at startup the node will check the Lucene version before loading the plugin.
You can disable that check using plugins.check_lucene: false
.
Known Plugins
editAnalysis Plugins
editSupported by Elasticsearch
Supported by the community
- Annotation Analysis Plugin (by Michal Samek)
- Combo Analysis Plugin (by Olivier Favre, Yakaz)
- Hunspell Analysis Plugin (by Jörg Prante)
- IK Analysis Plugin (by Medcl)
- Japanese Analysis plugin (by suguru).
- Mmseg Analysis Plugin (by Medcl)
- Morfologik (Polish) Analysis plugin (by chytreg)
- Russian and English Morphological Analysis Plugin (by Igor Motov)
- Hebrew Analysis Plugin (by Itamar Syn-Hershko)
- Pinyin Analysis Plugin (by Medcl)
- String2Integer Analysis Plugin (by Medcl)
- Vietnamese Analysis Plugin (by Duy Do)
Discovery Plugins
editSupported by Elasticsearch
- AWS Cloud Plugin - EC2 discovery and S3 Repository
- Azure Cloud Plugin - Azure discovery
- Google Compute Engine Cloud Plugin - GCE discovery
Supported by the community
- eskka Discovery Plugin (by Shikhar Bhushan)
River Plugins
editSupported by Elasticsearch
Supported by the community
- ActiveMQ River Plugin (by Dominik Dorn)
- Amazon SQS River Plugin (by Alex Bogdanovski)
- CSV River Plugin (by Martin Bednar)
- Dropbox River Plugin (by David Pilato)
- FileSystem River Plugin (by David Pilato)
- Git River Plugin (by Olivier Bazoud)
- GitHub River Plugin (by uberVU)
- Hazelcast River Plugin (by Steve Samuel)
- JDBC River Plugin (by Jörg Prante)
- JMS River Plugin (by Steve Sarandos)
- Kafka River Plugin (by Endgame Inc.)
- Kafka River Plugin 2 (by Mariam Hakobyan)
- LDAP River Plugin (by Tanguy Leroux)
- MongoDB River Plugin (by Richard Louapre)
- Neo4j River Plugin (by Steve Samuel)
- Open Archives Initiative (OAI) River Plugin (by Jörg Prante)
- Redis River Plugin (by Steve Samuel)
- RethinkDB River Plugin (by RethinkDB)
- RSS River Plugin (by David Pilato)
- Sofa River Plugin (by adamlofts)
- Solr River Plugin (by Luca Cavanna)
- St9 River Plugin (by Sunny Gleason)
- Subversion River Plugin (by Pascal Lombard)
- DynamoDB River Plugin (by Kevin Wang)
- IMAP/POP3 Email River Plugin (by Hendrik Saly)
- Web River Plugin (by CodeLibs Project)
- EEA ElasticSearch RDF River Plugin (by the European Environment Agency)
- Amazon S3 River Plugin (by Laurent Broudoux)
- Google Drive River Plugin (by Laurent Broudoux)
Transport Plugins
editSupported by Elasticsearch
Supported by the community
- ZeroMQ transport layer plugin (by Tanguy Leroux)
- Jetty HTTP transport plugin (by Sonian Inc.)
- Redis transport plugin (by Kevin Wang)
Scripting Plugins
editSupported by Elasticsearch
- Clojure Language Plugin (by Kevin Downey)
- Groovy lang Plugin
- JavaScript language Plugin
- Python language Plugin
- SQL language Plugin (by nlpcn)
Site Plugins
editSupported by the community
- BigDesk Plugin (by Lukáš Vlček)
- Elasticsearch Head Plugin (by Ben Birch)
- Elasticsearch HQ (by Roy Russo)
- Hammer Plugin (by Andrew Cholakian)
- Inquisitor Plugin (by Zachary Tong)
- Paramedic Plugin (by Karel Minařík)
- SegmentSpy Plugin (by Zachary Tong)
- Whatson Plugin (by Xiao Yu)
Snapshot/Restore Repository Plugins
editSupported by Elasticsearch
- Hadoop HDFS Repository
- AWS S3 Repository
Supported by the community
- GridFS Repository (by Kevin Wang)
Misc Plugins
editSupported by Elasticsearch
Supported by the community
- carrot2 Plugin: Results clustering with carrot2 (by Dawid Weiss)
- Elasticsearch Changes Plugin (by Thomas Peuss)
- Extended Analyze Plugin (by Jun Ohtani)
- Elasticsearch Graphite Plugin (by Alexander Reelsen)
- Elasticsearch Mock Solr Plugin (by Matt Weber)
- Elasticsearch New Relic Plugin (by Vinicius Carvalho)
- Elasticsearch Statsd Plugin (by Swoop Inc.)
- Terms Component Plugin (by Endgame Inc.)
- Elasticsearch View Plugin (by Tanguy Leroux)
- ZooKeeper Discovery Plugin (by Sonian Inc.)
- Elasticsearch Image Plugin (by Kevin Wang)
- Elasticsearch Experimental Highlighter (by Wikimedia Foundation/Nik Everett)
- Elasticsearch Security Plugin (by Hendrik Saly)
- Elasticsearch Taste Plugin (by CodeLibs Project)
- Elasticsearch SIREn Plugin: Nested data search (by SIREn Solutions)