How To Install

This page describes how to install OpenSensorHub (OSH for short) binary release so you can test it on your own platform. The process is actually really easy thanks to the use of embedded Jetty, so it should not take you more than 5 minutes to get a running OSH instance on your machine. (NOTE: Installation on Android phones and tablets is through a separate APK file).


In order for OSH to run, you will need a working installation of Java JDK 7.

On Linux, we have successfully tested SensorHub with both OpenJDK and Oracle JDK.


  • First download the latest OSH binary release (both 'core' and 'sensors' zip files) from our GitHub Release Page
  • Unzip both files to a directory of your choice
  • Execute the script (on Linux or MacOS) or launch.bat (on Windows)
  • You should now be able to connect to http://localhost:8181/sensorhub/test and get the message SensorHub web server is up

Note: This release has been tested on Ubuntu Linux, MacOS X and Windows 7.

Demo Configuration

The demo configuration provided with the binary release instructs OSH to start the following components:

  • The embedded Jetty server
  • The web admin UI
  • The simulated GPS example sensor
  • The simulated weather example sensor
  • Embedded storage instances for data produced by the 2 sensors
  • An SOS service connected to the real-time feeds and storages

Connect to the Sensor Observation Service (SOS)

You can connect right away to the SOS endpoint to get sensor data and metadata. Here are some examples that work with the installed simulated sensors:

Also take a look at this simple demo client that connects to the fake GPS live feed through websockets to display it on a map using OpenLayers. You can easily reproduce this locally.

More example data feed are also available Here.

Connect to the Admin Console

You can connect to the Admin Console at http://localhost:8181/sensorhub/admin.

When active, the console allows you to manage all OSH modules including sensors, processing chains, storage units, as well as service interfaces such as Sensor Observation Services (SOS) or Sensor Planning Services (SPS).

Logging Configuration

All logging is made via logback and the configuration is done via the logback.xml file included in the distribution. For instance, you can enable SensorHub debug logs by changing the following line in this file:

<logger name="org.sensorhub" level="info"/>


<logger name="org.sensorhub" level="debug"/>

See the Logback Documentation for more details.