Clone
5
Base Image
Patrick Gniza edited this page 2026-08-22 15:46:50 +02:00

Deutsch | English

Runtime Base Images

The build architecture uses separate reusable runtime images for the server and graphical Admin/Client workloads. This keeps expensive architecture-specific dependencies out of the version-specific final images.

Directories:

romexis-base/
romexis-gui-runtime/
romexis-common/

Server Runtime Responsibilities

romexis-base-jre provides:

  • Java 11 runtime
  • JavaFX/OpenJFX support
  • Microsoft SQL Server command-line tools
  • Firebird client libraries and tools
  • common OS packages
  • Chilkat native library and JAR
  • RomexisPropertyAgent.jar with embedded RxCr2 and OptionPane transformers
  • security updates

The expensive native/Java artifacts are therefore built once per architecture instead of once per Romexis version.


GUI Runtime Responsibilities

romexis-gui-runtime is shared by romexis-admin and romexis-client. It provides:

  • Java 17 and OpenJFX
  • Xvfb, Openbox and xcompmgr
  • x11vnc and noVNC/websockify
  • GTK/Mesa/OpenGL dependencies
  • Chilkat and RomexisPropertyAgent.jar, including the Java 17 Swing lifecycle null guard
  • the DxService compatibility library built from romexis-common/dxservice_dummy.c

Admin and Client therefore do not repeatedly install or compile these dependencies for every Romexis version.

The agent JAR embeds ASM and RomexisOptionPaneUIPatch.class; no separate ASM artifact is required in the final containers. The patch transforms only the affected in-memory listener class and does not rewrite the proprietary Romexis JAR on disk.


Architecture-Specific Tags

romexis-base-jre:11-amd64
romexis-base-jre:11-arm64
romexis-base-jre:11

romexis-gui-runtime:1-amd64
romexis-gui-runtime:1-arm64
romexis-gui-runtime:1

The runtime images are architecture-specific because they contain native runtime packages. The unsuffixed tags are multi-architecture manifests published only after both architecture builds succeed.


Firebird Tools

For Firebird initialization, the Romexis container needs the Firebird CLI tools.

The important tool is usually:

isql-fb

not:

isql

On Debian/Ubuntu, isql may refer to unixODBC. The Firebird initialization script should therefore default to:

ISQL="${ISQL:-isql-fb}"

Required packages are typically:

firebird3.0-utils
libfbclient2

Package names can differ depending on the base distribution.


SQL Server Tools

The MSSQL initialization script uses:

/opt/mssql-tools18/bin/sqlcmd

This is required for:

  • waiting for SQL Server
  • creating the database
  • creating the Romexis database user
  • importing SQL scripts
  • updating Romexis data paths