Page tree
Skip to end of metadata
Go to start of metadata

The following procedures apply to the new version of the Search Stack only, which replaces the previous Admin UI, Search UI, SEIA server and associated components with a new single application called Enterprise Search UI.

This includes the new Search UI on lasted version of Angular, Search API (SEIA server) and administration functionality.

This version is simplified by having the following Admin components

  • Best Bets
  • Thesaurus
  • Feedback
  • Stopwords
On this page

Installation Options

There are two main options available for installing the Enterprise Search UI. The recommended option is the Automatic Installation , which means using a recipe. The second option is a set of steps in the Manual Installation. Please review both options before you continue.

1 - Automatic Installation

Please Read

We strongly recommend following this approach to install the Enterprise Search UI. This will save you a lot of time.

The following recipes create a virtual machine on GNU/Linux with all of the requisites you need. These machines are intended to be used as development environments. However, with some modifications you can use these instructions for installing on clients' development, uat or prod environments.

If you are not comfortable developing on GNU/Linux, please contribute a recipe on Windows or follow the Manual Installation process. 


Vagrant was create by HashiCorp and allow to automate installations using a recipe or set of scripts. The following instructions creates a Centos 7 VirtualBox machine with gnome desktop and the following software already installed: elasticsearch (6.x), mongodb (3.4), Compass Mongo Client, Google Chome, Visual Studio Code and the ESUI source code already placed in the home folder. 

To install this solution follow this steps: 

  1. Install Virtual Box: 
  2. Install Vagrant:
  3. Run command in console
    vagrant plugin install vagrant-vbguest
  4. Download vagrant ESUI recipe from this git repository: 

  5. Open a console and navigate inside the vagrant folder and run the command: 

    vagrant up
  6. This process could take about 30 minutes.  During the process a VirtualBox windows will be opened, please wait until the console output process finish.

  7. Login into the machine a start configuring ESUI you will find the code in the home folder. (/home/vagrant)

  8. There is a folder at the root level of the recipe code called shared, this is useful to shares files between the host and the virtual machine. Will be only available if you start the machines with the vagrant command. Will not be available if you start the machines directly from VirtualBox.

  9. Use the command to stop the machine. From the same console you start it up.

    vagrant halt


user: vagrant password: vagrant


In progress

2 - Manual Installation

For the manual installation procedure, please see Manual Installation.

FAQ (Frequently Asked Questions)

My client has a Windows setup for the Enterprise Search UI. Will developing on GNU/Linux impact the behavior of the Enterprise Search UI when running on a Windows environment?

No, it will not.  The Enterprise Search UI uses multi-platform technologies like node and java.  Enterprise Search UI and other components will behave the same in both environments.

What do you mean by the SEIA server?

The Search Engine Independent API server (SEIA server) is a central part of the Enterprise Search UI. All requests from the user interface are sent to the SEIA server, and the responses are sent back and rendered. None of the SEIA server endpoints are tied to a specific search engine. In fact, no endpoint in the SEIA server is actually tied to anything. The SEIA server is completely configurable. Where search engine connectivity is required, this is performed using QPL in JavaScript.