Elasticsearch Configuration

Elasticsearch is powering the external API as well as the administrative user interface of Opencast. By default, Opencast will start its own, internal Elasticsearch node as part of the admin distribution and no special configuration or deployment is required.

Nevertheless, it is possible to connect Opencast to an external Elasticsearch instead. Reasons for this may be:

  • Ability for redundant services
  • Lightweight admin distributions
  • Cluster set-ups

Running Elasticsearch

When running Elasticsearch, it is recommended to deploy the same version Opencast includes as the client commands may otherwise not match the server. To check the version, take a look at the maven dependency declaration for the elasticsearch bundle in the search module.

For example, to quickly spin up an external Elasticsearch matching the current version using Docker, create a simple Elasticsearch configuration file called elasticsearch.yml:

cluster.name: opencast
discovery.type: single-node

…and run

% docker run -p 9200:9200 -p 9300:9300 \
    -v "$(pwd)/elasticsearch.yml":/usr/share/elasticsearch/config/elasticsearch.yml \

This will already give you a running cluster with the cluster name opencast. Note that the cluster name is important and you will need this to match Opencast's configuration.

Configuring External Nodes

To configure an external node, set the server's address in etc/custom.properties:


Once this is set, Opencast will not launch its own internal Elasticsearch anymore. If necessary, you can also specify a custom port in this configuration file.

Next, configure the correct cluster name in etc/elasticsearch.yml. Make sure that the correct cluster name is set in the configuration file of each index:

cluster.name: opencast

Opencast will now use the external Elasticsearch.