Attended Bridge installation

Creating a new Bridge connection

Create a new Bridge connection (plus symbol or context menu) on the Lobster Data Platform under “Configuration → Connections → Bridge connections”.

Settings

(1) Alias: The name of the Bridge (freely assignable).

(2) Bridge Password: The password of the Bridge (freely assignable). Important note: The password will never directly be displayed again after this step, but you can get it in obfuscated form, see section Unattended Bridge installation.

(3) Lobster Bridge Gateway: Use the default value “Lobster Default Gateway“. The use a private Gateway is explained in section Bridge Gateway private (DMZ).

(4) Partner: If you want to use AS2 (more on that later), you can select an appropriate partner (from the Lobster Data Platform). You can ignore this setting for now. For details see section AS2 (Bridge data service).

Downloading the Bridge

Now download the Bridge to your on-premise system by using button “Download Lobster Bridge“. The download works for Linux and Windows. Important note: Popups must be allowed, otherwise the download will fail. Unzip the installation package in the desired folder.

Hardware/Software/Ports

Please note the following hardware/software requirements and ports to be open.

Lobster Bridge

Hardware	Highly dependent on the expected load.
Operating system	Windows or Linux.
Software	Java 11 (up to date version, preferably Eclipse Adoptium. Make sure that the environment variable JAVA_HOME (and PATH) is set.
Inbound ports	None.
Outbound ports	Local → Lobster Data Platform or DMZ: 443 (TCP) depending on the use of the public (default) or private Gateway (more on that later). See section Bridge Gateway private (DMZ) for details. Local → Lobster API Server (https://api.lobster-world.com): 443 (TCP). Local → Bridge Gateway (https://bridge-gateway.lobster-cloud.com): 8444 (TCP).

Private Bridge Gateway

Hardware	Highly dependent on the expected load.
Operating system	Windows or Linux.
Inbound ports	(All standard DMZ requirements.) Lobster Data Platform → Local: 9000 (TCP). Lobster Bridge → Local: 8444 (TCP).
Outbound ports	(All standard DMZ requirements.) Local → Lobster API Server: 443 (TCP).

Lobster Data Platform

Inbound ports

Lobster Bridge → Local: 443 (TCP). (ETL/AS2)

Outbound ports

Local → Lobster API Server: 443 (TCP).

Local → Lobster Bridge Gateway: 443 (TCP). (Official Lobster Bridge Gateway)

Local → Lobster Bridge Gateway: 9000 (TCP). (Private DMZ/Gateway)

Installing the Bridge

Testing in console

For testing purpose, the Bridge can be started in the console:

> java -jar .\bin\wrapper.jar --run
...
...
[2025-09-18 08:26:51,451] Lobster Bridge Server started in 8731 ms, system is ready...
[2025-09-18 08:26:51,451] --------------------------------------------------------------------------

For the full set of commands see:

> java -jar .\bin\wrapper.jar

System service

To install the Bridge as system service, open a shell with the required user rights to install a system service. After installation of the service, start the service. The name of the service will appear as “LobsterApplicationWrapper“.

Windows: Open a shell as administrator.

Linux: Use "sudo" to run the command as root user: sudo java -jar wrapper.jar --install-service

Installing the service

> java -jar .\bin\wrapper.jar --install-service

Uninstalling the service

> java -jar wrapper.jar --uninstall-service

Starting the service

> java -jar .\bin\wrapper.jar --start-service

Stopping the service

> java -jar .\bin\wrapper.jar --stop-service

Checking the service status

> java -jar .\bin\wrapper.jar --service-status

Disabling and enabling the service (Linux only)

> java -jar .\bin\wrapper.jar --enable-service
> java -jar .\bin\wrapper.jar --disable-service

Service Wrapper log file

The Service Wrapper log file is ./logs/wrapper.log

Documentation Index