Running OpenLegacy Hub Enterprise Light Jar

This guide explains how to start and access OpenLegacy Hub Enterprise Light, including configuration for running with an external PostgreSQL database.

Prerequisites

• Java OpenJDK versions 17 to 21 (required) -

  You can use distributions such as:

  • Temurin
  • Amazon Corretto

Starting the Hub

To launch OpenLegacy Hub Enterprise Light:

java -jar light-hub.jar

The server will start on port 8080. Access the GUI at: http://localhost:8080

📘

To start on a different port -set this Environment variable:

OL_HUB_SERVER_PORT={PORT NUMBER}

A local directory will be created:

• Unix - {USER_HOME}/.ol/light-hub
• Windows - {USER_HOME}\.ol\light-hub

This directory will contain the PostgreSQL DB information. If users need to change this location for some security or limited access issue, they should use the following command:

java -Duser.home={PATH_TO_NEW_DIR} -Dvertx.cacheDirBase={PATH_TO_NEW_DIR}\tmp\vertx-cache -jar light-hub.jar

Using an External PostgreSQL Database

By default, Hub Light uses an embedded, local in-memory PostgreSQL database. If you want to use an external PostgreSQL database (instead of the embedded one), set the following environment variables before starting the application:

📘

Note: Authentication and authorization features (Keycloak IAM) are not included in Hub Light. If you require these features for production, use OpenLegacy Hub Enterprise instead.