Installing plugins

OpenSearch uses a command line tool called for managing plugins. This tool allows you to:

  • installed plugins.
  • Install plugins.
  • an installed plugin.

Print help text by passing -h or --help. Depending on your host configuration, you might also need to run the command with sudo privileges.

If you are running OpenSearch in a Docker container, plugins must be installed, removed, and configured by modifying the Docker image. For information, see Working with plugins

List

Use list to see a list of plugins that have already been installed.

Usage:

Example:

  1. $ ./opensearch-plugin list
  2. opensearch-alerting
  3. opensearch-anomaly-detection
  4. opensearch-asynchronous-search
  5. opensearch-cross-cluster-replication
  6. opensearch-geospatial
  7. opensearch-index-management
  8. opensearch-job-scheduler
  9. opensearch-knn
  10. opensearch-ml
  11. opensearch-notifications
  12. opensearch-notifications-core
  13. opensearch-observability
  14. opensearch-performance-analyzer
  15. opensearch-reports-scheduler
  16. opensearch-security
  17. opensearch-sql

You can also list installed plugins by using the CAT API.

Path and HTTP method

  1. GET _cat/plugins

Sample response

  1. opensearch-node1 opensearch-alerting                  2.0.1.0
  2. opensearch-node1 opensearch-anomaly-detection         2.0.1.0
  3. opensearch-node1 opensearch-asynchronous-search       2.0.1.0
  4. opensearch-node1 opensearch-cross-cluster-replication 2.0.1.0
  5. opensearch-node1 opensearch-job-scheduler             2.0.1.0
  6. opensearch-node1 opensearch-knn                       2.0.1.0
  7. opensearch-node1 opensearch-ml                        2.0.1.0
  8. opensearch-node1 opensearch-notifications             2.0.1.0
  9. opensearch-node1 opensearch-notifications-core        2.0.1.0

For a list of plugins that can be installed by name, see Additional plugins.

Usage:

Example:

  1. $ sudo ./opensearch-plugin install analysis-icu
  2. -> Installing analysis-icu
  3. -> Downloading analysis-icu from opensearch
  4. [=================================================] 100%   
  5. -> Installed analysis-icu with folder name analysis-icu

Remote zip files can be installed by replacing <zip-file> with the URL of the hosted file. The tool only supports downloading over HTTP/HTTPS protocols. For local zip files, replace with file: followed by the absolute or relative path to the plugin zip file as in the second example below.

Usage:

  1. bin/opensearch-plugin install <zip-file>

Example:

  1. # Zip file is hosted on a remote server - in this case, Maven central repository.
  2. $ sudo ./opensearch-plugin install https://repo1.maven.org/maven2/org/opensearch/plugin/opensearch-anomaly-detection/2.2.0.0/opensearch-anomaly-detection-2.2.0.0.zip
  3. -> Installing https://repo1.maven.org/maven2/org/opensearch/plugin/opensearch-anomaly-detection/2.2.0.0/opensearch-anomaly-detection-2.2.0.0.zip
  4. -> Downloading https://repo1.maven.org/maven2/org/opensearch/plugin/opensearch-anomaly-detection/2.2.0.0/opensearch-anomaly-detection-2.2.0.0.zip
  5. [=================================================] 100%   
  6. @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
  7. @     WARNING: plugin requires additional permissions     @
  8. @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
  9. * java.lang.RuntimePermission accessClassInPackage.sun.misc
  10. * java.lang.RuntimePermission accessDeclaredMembers
  11. * java.lang.RuntimePermission getClassLoader
  12. * java.lang.RuntimePermission setContextClassLoader
  13. * java.lang.reflect.ReflectPermission suppressAccessChecks
  14. * java.net.SocketPermission * connect,resolve
  15. * javax.management.MBeanPermission org.apache.commons.pool2.impl.GenericObjectPool#-[org.apache.commons.pool2:name=pool,type=GenericObjectPool] registerMBean
  16. * javax.management.MBeanPermission org.apache.commons.pool2.impl.GenericObjectPool#-[org.apache.commons.pool2:name=pool,type=GenericObjectPool] unregisterMBean
  17. * javax.management.MBeanServerPermission createMBeanServer
  18. * javax.management.MBeanTrustPermission register
  19. See http://docs.oracle.com/javase/8/docs/technotes/guides/security/permissions.html
  20. for descriptions of what these permissions allow and the associated risks.
  22. Continue with installation? [y/N]y
  23. -> Installed opensearch-anomaly-detection with folder name opensearch-anomaly-detection
  25. # Zip file in a local directory.
  26. $ sudo ./opensearch-plugin install file:/home/user/opensearch-anomaly-detection-2.2.0.0.zip
  27. -> Installing file:/home/user/opensearch-anomaly-detection-2.2.0.0.zip
  28. -> Downloading file:/home/user/opensearch-anomaly-detection-2.2.0.0.zip
  29. [=================================================] 100%   
  30. @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
  31. @     WARNING: plugin requires additional permissions     @
  32. @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
  33. * java.lang.RuntimePermission accessClassInPackage.sun.misc
  34. * java.lang.RuntimePermission accessDeclaredMembers
  35. * java.lang.RuntimePermission getClassLoader
  36. * java.lang.reflect.ReflectPermission suppressAccessChecks
  38. * javax.management.MBeanPermission org.apache.commons.pool2.impl.GenericObjectPool#-[org.apache.commons.pool2:name=pool,type=GenericObjectPool] registerMBean
  39. * javax.management.MBeanPermission org.apache.commons.pool2.impl.GenericObjectPool#-[org.apache.commons.pool2:name=pool,type=GenericObjectPool] unregisterMBean
  40. * javax.management.MBeanServerPermission createMBeanServer
  41. * javax.management.MBeanTrustPermission register
  42. See http://docs.oracle.com/javase/8/docs/technotes/guides/security/permissions.html
  43. for descriptions of what these permissions allow and the associated risks.
  45. Continue with installation? [y/N]y
  46. -> Installed opensearch-anomaly-detection with folder name opensearch-anomaly-detection

The opensearch-plugin install tool also accepts Maven coordinates for available artifacts and versions hosted on . opensearch-plugin will parse the Maven coordinates you provide and construct a URL. As a result, the host must be able to connect directly to Maven Central. The plugin installation will fail if you pass coordinates to a proxy or local repository.

Usage:

Example:

  1. $ sudo ./opensearch-plugin install org.opensearch.plugin:opensearch-anomaly-detection:2.2.0.0
  2. -> Installing org.opensearch.plugin:opensearch-anomaly-detection:2.2.0.0
  3. -> Downloading org.opensearch.plugin:opensearch-anomaly-detection:2.2.0.0 from maven central
  4. [=================================================] 100%   
  5. @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
  6. @     WARNING: plugin requires additional permissions     @
  7. @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
  8. * java.lang.RuntimePermission accessClassInPackage.sun.misc
  9. * java.lang.RuntimePermission accessDeclaredMembers
  10. * java.lang.RuntimePermission getClassLoader
  11. * java.lang.RuntimePermission setContextClassLoader
  12. * java.lang.reflect.ReflectPermission suppressAccessChecks
  13. * java.net.SocketPermission * connect,resolve
  14. * javax.management.MBeanPermission org.apache.commons.pool2.impl.GenericObjectPool#-[org.apache.commons.pool2:name=pool,type=GenericObjectPool] registerMBean
  15. * javax.management.MBeanPermission org.apache.commons.pool2.impl.GenericObjectPool#-[org.apache.commons.pool2:name=pool,type=GenericObjectPool] unregisterMBean
  16. * javax.management.MBeanServerPermission createMBeanServer
  17. * javax.management.MBeanTrustPermission register
  18. See http://docs.oracle.com/javase/8/docs/technotes/guides/security/permissions.html
  19. for descriptions of what these permissions allow and the associated risks.
  21. Continue with installation? [y/N]y
  22. -> Installed opensearch-anomaly-detection with folder name opensearch-anomaly-detection

Restart your OpenSearch node after installing a plugin.

Remove

You can remove a plugin that has already been installed with the remove option.

Usage:

  1. bin/opensearch-plugin remove <plugin-name>

Example:

  1. $ sudo $ ./opensearch-plugin remove opensearch-anomaly-detection
  2. -> removing [opensearch-anomaly-detection]...

When installing plugins that require additional privileges not included by default, the plugins will prompt the user for confirmation of the required privileges. To grant all requested privileges, use batch mode to skip the confirmation prompt.

To force batch mode when installing plugins, add the -b or --batch option:

Available plugins

Major, minor, and patch plugin versions must match OpenSearch major, minor, and patch versions in order to be compatible. For example, plugins versions 2.3.0.x work only with OpenSearch 2.3.0.

The following plugins are bundled with all OpenSearch distributions except for minimum distribution packages.

1Dashboard Notebooks was merged in to the Observability plugin with the release of OpenSearch 1.2.0.
2Performance Analyzer is not available on Windows.

Plugin NameEarliest Available Version
analysis-icu1.0.0
analysis-kuromoji1.0.0
analysis-nori1.0.0
analysis-phonetic1.0.0
analysis-smartcn1.0.0
analysis-stempel1.0.0
analysis-ukrainian1.0.0
discovery-azure-classic1.0.0
discovery-ec21.0.0
discovery-gce1.0.0
ingest-attachment1.0.0
mapper-annotated-text1.0.0
mapper-murmur31.0.0
mapper-size1.0.0
repository-azure1.0.0
repository-gcs1.0.0
repository-hdfs1.0.0
repository-s31.0.0
store-smb1.0.0
transport-nio1.0.0