EEA & Eionet documentation hub

Browse documentation for IT-systems used by the European Environment Agency and the Eionet network.

EEA ElasticSearch




Notice: This repository has been replaced by a better and dockerised version



EEA elasticsearch is an elasticsearch specific setup by the European Environment Agency for querying data in the EEA’s Semantic Data Service and designing specific search interfaces and widgets to be used in a CMS.


  • Introduction
  • Components
  • Live demos
  • Development instalation using Vagrant
  • Installation
  • Dependencies
  • Source code
  • Copyright and license
  • Funding and project management


The setup is composed of the following:

  1. An elasticsearch instance flavoured with following plugins
  2. EEA ElasticSearch RDF River Plugin
  3. Jetty Plugin
  4. FacetView, a pure JavaScript library for browsing data using an elasticsearch endpoint
  5. elasticsearch service-wrapper, a script for running elasticsearch using Java Service Wrapper.

This packages specifically includes:

  1. Development and production configuration files for elasticsearch and Apache.
  2. Custom static pages using facetview js library.
  3. PAM, an application using the elasticsearch endpoint.

Live demos

Development instalation using Vagrant

We provide most of the setup steps in a Vagrant box for a clean install in a virtual machine.

In the same directory clone these projects:

git clone

git clone git clone

git clone

Follow instructions in vagrant/README.rst

If you want a local setup follow the instructions in the next section.


  1. Clone project

git clone

  1. Install elasticsearch, e.g. in /var/local/elasticsearch

  2. Replace its config folder with a symlink to eea.elasticsearch/etc/production/config

  3. Install RDF River Plugin, using elasticsearch plugin script inside its bin folder:

    bin/plugin –url –install eea-rdf-river-1.0

  4. Install Jetty Plugin in the same manner:

    bin/plugin –url –install elasticsearch-jetty-0.90.0

  5. Install useful plugins for monitoring and debugging:

    bin/plugin -install mobz/elasticsearch-head bin/plugin -install lukas-vlcek/bigdesk bin/plugin -install OlegKunitsyn/elasticsearch-browse bin/plugin -install polyfractal/elasticsearch-inquisitor

  6. Install and configure elasticsearch-service wrapper:

    git clone cd elasticsearch-servicewrapper/service vim elasticsearch.conf # configure path to elasticsearch ./elasticsearch install

  7. Configure users and roles for elasticsearch requests in eea.elasticsearch/etc/production/config/, see Adding Basic Authentication.

  8. Start elasticsearch service

    service elasticsearch start

  9. Install facetview

    git clone

  10. Link eea.elasticsearch/etc/production/httpd.elasticsearch.conf in /etc/httpd/conf.d and check settings

  11. Reload Apache

    service httpd reload


eea.elasticsearch has the following dependencies:

Source code

Latest source code:

The Initial Owner of the Original Code is European Environment Agency (EEA). All Rights Reserved.

The EEA ElasticSearch (the Original Code) is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

More details under eea.elasticsearch/docs/LICENSE.txt

Funding and project management

EEA - European Environment Agency (EU)

Edit this page