Install OpenSearchServer on Ubuntu
5 March, 2021 by
Install OpenSearchServer on Ubuntu
| No comments yet

Checking your Java version

In a shell, enter the command line

java -version

Check whether your Java version is 7 or newer:

  • If your version is not Version 7 or greater you’ll need to update your Java engine
  • If you don’t have Java, install it (see below)

Installing Java

Our Open Source-friendly recommendation is that you install the latest OpenJDK (1.7.0 as of this writing).

To install OpenJDK just use your favorite package manager:

apt-get install openjdk-7-jdk

Installing OpenSearchServer

We recommend that you always get the latest version of OSS on SourceForge.

Please download the **opensearchserver-X.X.X-bXXX.deb** package for Debian, then install it as in the example below:

dpkg -i opensearchserver-X.X.X-bXXX.deb

Once installed you will get the following folders:

  • /var/lib/opensearchserver: Contains all your data (indexes).
  • /usr/share/opensearchserver: Contains all your OSS binaries.

You also get the following files:

  • /etc/opensearchserver: The configuration file of your OpenSearchServer instance
  • /etc/init.d/opensearchserver: The script used by the system to start and stop the OpenSearchServer instance.

Running it

Just use the service command:

service opensearchserver start

To access your OSS Back Office, open you browser (Firefox, Chromium, Opera, Safari…) and open the page http://yourserver:9090

Stopping it

Use the service command with the stop parameter:

service opensearchserver stop


The configuration file is located at /etc/opensearchserver.

Changing the listening port

If by chance you already have a server listening on the 9090 tcp port you’ll have to make a change in the config files.

Locate the line starting with:


Then change that to another port:


Restart your OpenSearchServer instance:

service opensearchserver stop
service opensearchserver start

Your OpenSearchServer Back Office is now available at this address: http://yourserver:9091

Changing the memory usage

By default, OpenSearchServer don’t set the memory allocation. It uses the default value from the Java Virtual Machine.

If you need to increase it, just edit the configuration file.

Locate the line with:

#JAVA_OPTS="-Xms1G -Xmx1G"

Uncomment the line, and set the memory value as needed:

JAVA_OPTS="-Xms2G -Xmx2G"

Restart OpenSearchServer.

Be aware that if you set a value greater than the physical memory available, OpenSearchServer will not start.

Sign in to leave a comment