Setting jBEAM Startup Parameters

Setting jBEAM Startup Parameters

Starting with the 2025 version of jBEAM, startup parameters can be set at two levels. Settings such as memory usage, license server, and debug mode can be configured at the user level without admin rights:

Scope

Paths (for Windows)

Permissions

Scope

Paths (for Windows)

Permissions

System-wide

%ProgramData%\jBEAM\start_jBEAM_config.txt

Requires admin rights

User-level

%AppData%\jBEAM\start_jBEAM_config.txt

No admin rights needed

During jBEAM installation, the installer creates a system-wide configuration file that applies to all users (hence the need for admin rights). Users can copy this file to their user directory and make individual changes.

Configuration Parameters

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. Change it only if the server uses a different port, and update your 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

  • Default: false

  • 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

jBEAM supports many additional startup parameters, most of which are only required for specific use cases. See the jBEAM Start Parameter List for an overview.

Use startParameters to specify these options as space-separated -key=value pairs, as shown in the example below.

  • Format: -key=value pairs separated by spaces

  • Example:

    startParameters=-WindowTitle="My jBEAM" -WindowWidth=800 -WindowHeight=300

Not allowed to set at user-level.