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 |
|---|---|---|
System-wide |
| Requires admin rights |
User-level |
| 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/noDefault:
noExample:
redirectConsole=yes
singleInstance
Controls whether multiple jBEAM instances can run simultaneously.
Values:
true→ Reuse existing instancefalse→ Always start a new instance
Default:
falseExample:
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 systemsmaxMemory64→ 64-bit systems
Example:
maxMemory32=1g maxMemory64=14g
javaExe
Defines the Java executable used to start jBEAM.
Values:
auto→ Automatically detect Java installationAbsolute 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=valuepairs separated by spacesExample:
startParameters=-WindowTitle="My jBEAM" -WindowWidth=800 -WindowHeight=300
Not allowed to set at user-level.