It is mandatory to have a Nexus Repository user account in order to install the RTLS Hub on your machine.

Getting the Latest Docker Compose

Please login to Nexus Repository to download the Docker Compose.


After logging in, click on “Browse” to access the repository content.


In the directory “omlox-extra”, navigate to the “bundle” folder and download the Docker compose “”.


Create a new folder named “rtls-bundle-small” on the desktop and extract all the content from the zip file to this folder. Please copy the path of the “rtls-bundle-small” directory.


Running the docker compose

It is important to run the Docker Compose from the directory copied above through Windows PowerShell. To do this, change the directory using Windows PowerShell.

Open Windows PowerShell from the start menu.


To run the Docker Compose, log in to Nexus Repository through Windows PowerShell

docker login


Press “Enter”. The system will prompt for the username and password of the Nexus repository. Input your user credentials to log in and press “Enter”


once a user is logged in to Nexus repository through docker registry, it is not needed to give user account credentials every time until the user logs out. A user can log out by executing command docker logout


To change the directory, execute the following command.

cd (Please paste copied directory path of “rtls-bundle-small”)


To start the Docker Compose, execute the following command in Windows PowerShell.

docker-compose up -d


It will take few minutes to download the Docker images and setting up the RTLS Hub. Open a web browser and enter the web address http://localhost:8081 . This will allow you to access the web frontend of the RTLS Hub.


Run the Simulation

In order to test features and functionalities of the RTLS Hub, a simulation package will be provided. This package consists of simulated data for zones, fences, and moving trackables, and was produced at our testing site in Teningen, Germany. Please download the Simulation Package with your Nexus Repository login credentials. After testing the RTLS Hub using the simulation package, you may also test using your own network(s) and data. Please consult Heidelberg Mobil International GmbH for support if needed.


If you have the RTLS Hub already installed on your machine, it is mandatory to stop the running RTLS Hub in order to run the simulation. Running this simulation will import the simulation data in the current RTLS Hub instance.

Stop the running RTLS Hub

Please make sure you are in the same directory you installed the RTLS Hub. In this case, “rtls-bundle-small”

To stop the running RTLS Hub, execute the following command in Windows PowerShell and press “Enter”.

docker-compose down

This will stop the running RTLS Hub. Windows PowerShell will display the status of the operation.


This ensures the running RTLS Hub is stopped and allows the user to modify the configuration data.

Import the simulation

Open the simulation package downloaded from the Nexus repository. Copy the files from the package.


Paste the files into the “hub-data” folder in the directory where the RTLS Hub bundle was extracted during the RTLS Hub installation.


This ensures that the RTLS Hub will have simulation data to display in the frontend.

Run the Docker compose again to start the RTLS Hub with the simulation data.


Open a browser and enter the web address http://localhost:8081 .This will provide access to the RTLS Hub frontend. The zones and fences from our test site in Teningen, Germany will be visible on the map.


This map will also display the simulated trackables moving along a fixed path. As trackables move through fences, the left side pane will list triggered events.