/
Setting jBEAM Startup Parameters

Setting jBEAM Startup Parameters

Starting with the 2025 version of jBEAM, startup parameters such as memory usage, license server and debug mode can be set at two levels:

Scope

Paths (for Windows)

Permissions

Scope

Paths (for Windows)

Permissions

System-wide (all users)

%ProgramData%\jBEAM\start_jBEAM_config.txt

Requires admin rights

User-level (current user)

%AppData%\jBEAM\start_jBEAM_config.txt

No admin rights needed

The jBEAM installer creates the system-wide configuration file. To use individual settings, copy this file to the user directory i.e. for Windows %AppData%\jBEAM\ and adjust the settings as needed.

Configuration Parameters

Availlable settings are:

licenseServer

Specifies the hostname or address of the license server for network licenses.

  • Values: <hostname> or <ip>

  • No Default

  • Examples: (only one line allowed)

    licenseServer=my-license-server licenseServer=192.168.1.1 licenseServer=192.168.1.1:22350

The default port is 22350. Add a different port here only if the server uses one, and adjust the local firewall accordingly!

redirectConsole

Controls whether console output writes to log files. If enabled, the command line shows the exact storage location, for example, on Windows: %AppData%\jBEAM\log\

  • Values: yes / no

  • Default: no

  • Example:

    redirectConsole=yes

singleInstance

Controls whether multiple jBEAM instances can run simultaneously.

  • Values:

    • true → Reuse existing instance

    • false → Always start a new instance

  • Example:

    singleInstance=true

maxMemory32 / maxMemory64

Defines the maximum heap memory available to the Java process.

  • Values: Memory size (e.g. 512m, 2g, 14g)

  • Use according to the system architecture:

    • maxMemory32 → 32-bit systems

    • maxMemory64 → 64-bit systems

  • Example:

    maxMemory32=1g maxMemory64=14g

javaExe

Defines the Java executable used to start jBEAM.

  • Values:

    • auto → Automatically detect Java installation

    • Absolute path → e.g. C:\Program Files\Java\bin\java.exe

  • Example:

    javaExe=auto

Not allowed to set at user-level.

startParameters

This parameter defines additional startup parameters in sequence. Use it only in specific exceptional cases.

  • Example:

    startParameters=-help

Using the -help parameter lists all available jBEAM startup parameters but does not launch jBEAM.

Not allowed to set at user-level.